Node.js 深度调试方法解析
在 Node.js 项目开发过程中，随着项目的发展，调用关系越来越复杂，调试工具的重要性日益凸显。
Node(v6.3+)集成了方便好用 V8 Inspect 调试器，允许我们通过 Chrome DevTools 进行图形化的调试和性能分析。同时，我们也可以使用 VS Code，Webstorm 等支持的编辑器对 Node.js 程序进行调试。
Node Inspect
要想启动调试器，我们需要在启动 Node.js 应用程序时传入 --inspect 标志，也可以使用该标志提供自定义的端口，例如 --inspect=9222 将会在 9222 端口上接受开发者工具的连接。
一段简单的代码
function log() {
let a = 1;
console.log(a);
a = 2;
console.log(a);
}
log();
使用 node --inspect 启动
这时我们会发现，程序直接执行完成了，没有中断，导致我们无法使用 Chrome DevTools 进行调试。对于这种直接执行的代码，我们可以使用 --inspect-brk 参数，在应用程序代码的第一行终端，然后再进行调试。
Chrome DevTools
当开启 Node 调试后，我们可以打开 Chrome，访问 chrome://inspect ，在 Devices 中查找到我们的 Node.js 程序，点击 inspect 打开调试面板进行操作
在调试工具窗口，我们可以设置断点，运行程序进行调试
运行中程序调试
在某些情况下，我们可以需要对正在运行的 Node.js 程序进行调试，比如 Express Web 服务。我们不可能停止服务，再以 --inspect 运行调试。
对于这种情况，我们可以先获取服务的进程 Id
向脚本进程发送 SIGUSR1 信号，就可以建立调试连接
kill -SIGUSR1 34943
复制代码
在 Windows 平台下，可以使用下面的命令
node -e 'process._debugProcess(30464)'
需要注意的是：这种调试任然会中断服务进程的执行。
VS Code 调试
快速调试
对于简单的应用程序，可以打开文件，按 F5 并选择调试类型为 Node，即可进行调试
使用配置调试
对于大多数的调试场景，更推荐使用配置文件，因为它可以配置并保存调试设置的信息，方便我们下次快速使用。在 VC Code 中，调试配置通常存储在 .vscode 文件夹下的 launch.json 文件中 。可以点击左侧栏目中的调试图标，快速创建 launch.json 文件
VS Code 会自动下面类似的 launch.json 调试配置文件，其中 program 代表我们需要调试的文件路径，workspaceFolder 为当前工作区的路径，通常是项目的根目录
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "启动程序",
"skipFiles": ["<node_internals>/**"],
"program": "${workspaceFolder}/index.js"
}
]
}
设置断点，即可启动调试，并在左侧的树视图中看到变量对应的值以及堆栈信息
launch.json
launch.json 中有许多不同的属性，支持不同的调试器和调试场景，下面的属性在每个启动配置中是必须的
- name - 当前调试配置项的名称，可读性要好，区分每个调试配置项
- type - 用于此启动配置的调试器的类型。每个已安装的调试扩展都引入一种类型：例如node，php，go 等。
- request - 当前调试项的类型，目前支持 launch 和 attach 两种类型。launch 适合调试未启动的程序，attach 则适合调试已经运行的程序。
一些其他比较有用的选项：
- program - 启动调试器时要运行的可执行程序或文件
- args - 传递给程序进行调试的参数
- env - 调试时的环境变量
- envFile - 包含环境变量键值对的文件
- stopOnEntry - 程序启动时立即中断
- port - 连接到正在运行的调试器的端口
- runtimeExecutable - 启用调试的可执行 Runtime，默认是 Node
日志点 - Logpoints
VS Code 提供了好用的调试小工具 - 日志点，日志点是断点的一种变体，它不 "中断 "进入调试器，而是将一条消息记录到控制台，日志点对于在调试不能暂停或停止的生产服务器时注入日志特别有用。
NPM 脚本调试
除了使用 node 启动 Node.js 项目之外，VS Code 还支持自定义启动程序 runtime，借助这个能力，可以直接使用 NPM 启动调试。如下面，使用 npm run debug 启动调试
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "启动程序",
"skipFiles": ["<node_internals>/**"],
"program": "${workspaceFolder}/index.js"
}
]
}
launch.json
{
"type": "node",
"request": "launch",
"name": "NPM 启动",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "debug"],
"port": 9229
}
TypeScript 调试
VS Code 内置的 Node.js 的调试器支持 JavaScript Source Map，可以结合 Source Map 调试转译前的代码，如 TypeScript，压缩混淆的 JavaScript 代码等都可以利用 Source Map 的支持调试源码。
我准备了一个简单的 TS Server Demo，可以直接 Clone 源码本地测试。下面是项目中的 src/index.ts 文件，创建了一个 HTTP Server
import * as http from "http";
let reqCount = 1;
http
.createServer((req, res) => {
const message = `Request Count: ${reqCount}`;
res.writeHead(200, { "Content-Type": "text/html" });
res.end(`<html><div>${message}</div></html>`);
console.log("handled request: " + reqCount++);
})
.listen(3000);
console.log("server running on port 3000");
创建 tsconfig.json 配置，配置编译生成 Source Map
{
"compilerOptions": {
"outDir": "./dist",
"sourceMap": true
},
"include": ["src/**/*"]
}
使用 tsc 编译一下，生成 JS 代码：dist/index.js，创建调试配置，入口文件为 dist/index.js
{
"type": "node",
"request": "launch",
"name": "Launch Program",
"program": "${workspaceFolder}/dist/index.js",
"skipFiles": ["<node_internals>/**"]
}
然后打断点，启动调试，浏览器访问 http://localhost:3000，即可看到调试进入了 TS 文件
远程调试
当我们需要在真实的服务器等远程运行环境调试 Node.js 时，我们可以利用上面提到的方式，在服务器上开启 Node.js 调试功能，并在本地连接上远程的调试端口进行调试。
VS Code 默认支持远程调试，我们需要 launch.json 配置文件中指定远程服务的 IP 地址以及端口，如下所示：
{
"type": "node",
"request": "attach",
"name": "远程调试",
"address": "IP 地址",
"port": "9229"
}
VS Code 会自动加载远程的文件，展示为只读代码供调试使用。
如果想要在调试的过程中编辑源代码，或者更好的调试体验，可以在远程文件夹和本地项目之间设置一个映射。VS Code 提供了 localRoot 和 remoteRoot 属性来映射本地 VS Code 项目和（远程）Node.js 文件夹：
{
"type": "node",
"request": "attach",
"name": "远程调试",
"address": "IP 地址",
"port": "9229",
"localRoot": "${workspaceFolder}/src",
"remoteRoot": "/var/user/"
}
在建立映射关系后，即可在本地项目进行断点调试，远程的断点信息会同步到本地项目，使用起来十分方便。
子进程调试
与普通进程调试原理一致，子进程调试时也需要传入 --inspect 参数，这一点需要特别注意，否则无法启动子进程调试。
如下通过子进程启动 Server 的例子：
// fork.js 文件
const { spawn } = require("child_process");
const sp = spawn("node", ["./fork_server.js"]);
console.log("父进程 PID", sp.pid);
sp.stdout.on("data", (data) => {
console.log(`stdout: ${data}`);
});
sp.stderr.on("data", (data) => {
console.error(`stderr: ${data}`);
});
如果直接使用 node --inspect 启动主进程的话，会发现只显示了主进程的调试端口，这就是因为我们在程序中启动子进程时没有传递 --inspect 选项导致的。
这里我们在启动进程时添加上 --inspect 参数，同时注意要指定一个默认 9229 端口之外的端口号，避免调试端口冲突
- const sp = spawn("node", ["./fork_server.js"]);
+ const sp = spawn("node", ["--inspect=9230", "./fork_server.js"]);
再次启动，就能看到两个调试信息输出了
当然，怎么能少得了强大的 VS Code 呢。VS Code 的 Node 调试器提供了一种机制，可以追踪所有子进程，并在调试模式下，自动链接进程。可以通过 autoAttachChildProcesses 属性开启此机制：
{
"type": "node",
"request": "launch",
"name": "启动程序",
"program": "${workspaceFolder}/fork.js",
"autoAttachChildProcesses": true
}
启动后，即可对父进程，或子进程进行断点调试，效果如下
结语
大家有什么要说的，欢迎在评论区留言
到此这篇关于Node.js 深度调试方法解析的文章就介绍到这了,更多相关Node.js 深度调方法内容请搜索猪先飞以前的文章或继续浏览下面的相关文章希望大家以后多多支持猪先飞！
相关文章
- 在开发过程中，使用Visual Studio的断点调试功能可以很方便帮我们调试发现程序存在的错误，同样Visual Studio也支持对SQL Server里面的存储过程进行调试，下面就让我们看看具体的调试方法。...2021-09-22
- 现在我们介绍一种在Node下检查简单错误的JS代码验证工具JSHint。 JSHint的具体介绍参考http://www.jshint.com/about/，说直白点儿，JSHint就是一个检查JS代码规范与否的工具，它可以用来检查任何（包括server端和client端...2014-05-31
- 这次文章要给大家介绍的是node.JS md5加密中文与php结果不一致怎么办，不知道具体解决办法的下面跟小编一起来看看。 因项目需要，需要Node.js与PHP做接口调用，发现nod...2017-07-06
- 使用require('crypto')调用加密模块。加密模块需要底层系统提供OpenSSL的支持。它提供了一种安全凭证的封装方式，可以用于HTTPS安全网络以及普通HTTP连接。该模块还提供了一套针对OpenSSL的hash（哈希），hmac（密钥哈希），cipher...2014-06-07
- 1.什么是异步编程？ 异步编程是指由于异步I/O等因素，无法同步获得执行结果时， 在回调函数中进行下一步操作的代码编写风格,常见的如setTimeout函数、ajax请求等等。示例： for (var i = 1; i <= 3; i++) {setTimeout(functi...2015-10-23
- 本文介绍基于nodejs+express+art-template的留言板功能。包含列表界面、添加界面和发送留言功能，具有一定的参考价值，感兴趣的小伙伴们可以参考一下...2021-09-21
安装使用Mongoose配合Node.js操作MongoDB的基础教程
这篇文章主要介绍了安装使用Mongoose来让Node.js操作MongoDB的基础教程,前端js+后端node+js操作MongoDB正是所谓最流行的一种JavaScript全栈开发方案,需要的朋友可以参考下...2016-03-03- 这篇文章主要给大家介绍了关于C#客户端程序Visual Studio远程调试的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧...2020-06-25
- 这篇文章主要介绍了idea 无法debug调试的解决方案，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2020-09-09
- 这篇文章主要为大家详细介绍了node.js从数据库获取数据的具体代码，nodejs可以获取具体某张数据表信息，感兴趣的朋友可以参考一下...2016-05-09
- 首先，在各个浏览器中，断点调试支持的最好的当然是Firefox，Firefox不仅可以使用Firebug调试页面js脚本，还可以用高级调试工具例如JavaScript Debugger (Venkman) 来调试Firefox扩展里的js。除此之外，Firefox还支持一些更为...2015-10-23
- 这篇文章介绍的是一个小技巧来获取node.js项目根目录，这个技巧非常实用。有需要的朋友们可以参考借鉴，下面来一起看看吧。...2016-10-02
- post请求：复制代码 代码如下: request.post('/api/pet') .end(function(resp,err){ if (resp.body.status===200) { alert('yay got ' + JSON.stringify(res.body)); } else { return nex...2015-03-15
- 这篇文章主要介绍了node.js和Deno的区别，对deno感兴趣的同学，可以参考下...2021-04-27
- 这篇文章主要介绍了Node.js之http模块的用法，对Node.js感兴趣的同学，可以参考下...2021-04-25
- 这篇文章主要介绍了c# 代码调试技巧和如何远程调试，帮助大家更好的理解和使用c#编程语言，感兴趣的朋友可以了解下...2020-12-08
- 这篇文章主要介绍了node.js如何操作MySQL数据库，帮助大家更好的进行web开发，感兴趣的朋友可以了解下...2020-10-29
- 这篇文章主要为大家详细介绍了三种Node.js写文件的方式，感兴趣的小伙伴们可以参考一下...2016-03-10
- 这篇文章主要介绍了node.js 全局变量的具体使用，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧...2021-04-15
- 这两天为了这个问题, Gitter 上问, Twitter 上问, GitHub 上问, 两天没反应 原来写博客的 jlongster 不理我, 我也不知道 Webpack 作者的联系方式 最后在 Gitter 上发的消息他似乎看到了, 就粗略地解释了一遍, 醍醐灌...2015-10-23