Node.js / 系统课时

使用调试器定位问题

使用调试器定位问题

运行时错误如果只靠反复加 console.log 猜测,很容易遗漏变量在某一层被改坏的位置。本课用 Node.js 内置 Inspector 复现一个折扣计算错误,通过断点、Scope、Watch 与调用栈定位 NaN 的来源,并完成修复验证。

学习目标

  • 使用 --inspect-brk 启动 Node.js 调试会话,并连接 Chrome DevTools。
  • 在断点处检查局部变量、表达式值和调用栈,定位错误值第一次出现的位置。
  • 根据调试证据修复问题,并用正常运行结果确认缺陷已经消失。

先复现并让进程停下来

先把下面程序保存为 debug-demo.js。输入数据里的会员等级是大写 VIP,而费率表使用小写键;这会让 rates[user.level] 得到 undefined,后续乘法产生 NaN。

js
function calculateDiscount(user, price) {
  const rates = { normal: 0, vip: 0.2 };
  const rate = rates[user.level];
  const total = price - price * rate;
  return total;
}

function main() {
  const user = { id: 'u-42', level: 'VIP' };
  console.log({ total: calculateDiscount(user, 200) });
}

main();

直接运行 node debug-demo.js 的预期输出:

text
{ total: NaN }

确认问题可稳定复现后,用内置 Inspector 在执行用户代码前暂停。--inspect-brk 默认只监听本机回环地址,适合本地调试;不要把调试端口直接暴露到公网。

bash
node --inspect-brk debug-demo.js

预期输出的关键行如下,<PORT> 和 <ID> 会随环境变化,实际值可能不同:

text
Debugger listening on ws://127.0.0.1:<PORT>/<ID>

此时 main() 还没有执行,因此终端不会立刻打印 { total: NaN }。如果问题只在服务启动一段时间后出现,可改用 node --inspect debug-demo.js,让进程先运行再附加调试器。

用断点检查变量而不是猜

在 Chrome 地址栏打开 chrome://inspect,连接刚启动的 Node.js 进程。在 Sources 中打开 debug-demo.js,把断点设在 const rate = rates[user.level]; 这一行,然后 Resume 到该断点。

  1. 在 Scope 中确认 user.level 是 "VIP",rates 只有 normal 与 vip 两个键。
  2. 在 Watch 中加入 rates[user.level],结果应为 undefined。
  3. 再加入 user.level.toLowerCase(),结果应为 "vip",这直接证明问题来自大小写不一致,而不是价格计算公式。
  4. 查看 Call Stack,应能看到 calculateDiscount 由 main 调用;如果错误值来自更深层函数,就沿栈向上检查最早传入异常数据的调用者。

Chrome DevTools 中断点、Scope、Watch 与调用栈的位置

用单步执行确认错误传播

停在 rate 这一行后按 Step over。执行结束时,rate 会变成 undefined;再执行下一行,total 会变成 NaN。这两个相邻变化能把根因缩小到一次属性读取,而不是把注意力浪费在 console.log 或函数返回阶段。

如果断点停得太晚,可在 Call Stack 中选择上层帧,检查调用者传入的参数;如果错误偶发,可把条件断点设置为 user.level !== user.level.toLowerCase(),只在数据不符合约定时暂停,避免每次请求都中断。

修复后重新运行验证

修复时不要只给 undefined 一个默认费率把问题吞掉,而应先把输入规范化,再对未知等级显式报错。下面是替换 calculateDiscount 中费率读取部分的片段示例,依赖前面的 rates 对象与 user 参数。

js
const level = user.level.toLowerCase();

if (!(level in rates)) {
  throw new Error(`Unknown user level: ${user.level}`);
}

const rate = rates[level];

保存修改后关闭调试会话,正常运行程序验证结果。这样可以确认修复不仅让断点里的变量正确,也恢复了最终业务输出。

bash
node debug-demo.js

预期输出:

text
{ total: 160 }

当问题发生在初始化阶段时优先用 --inspect-brk,发生在长时间运行的服务里则用 --inspect 后再附加。定位顺序始终从“错误结果”回到“错误值第一次出现的语句”,再用调用栈确认是谁把异常数据传进来。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用调试器定位问题

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通