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。
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 的预期输出:
{ total: NaN }确认问题可稳定复现后,用内置 Inspector 在执行用户代码前暂停。--inspect-brk 默认只监听本机回环地址,适合本地调试;不要把调试端口直接暴露到公网。
node --inspect-brk debug-demo.js预期输出的关键行如下,<PORT> 和 <ID> 会随环境变化,实际值可能不同:
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 到该断点。
- 在 Scope 中确认
user.level是"VIP",rates只有normal与vip两个键。 - 在 Watch 中加入
rates[user.level],结果应为undefined。 - 再加入
user.level.toLowerCase(),结果应为"vip",这直接证明问题来自大小写不一致,而不是价格计算公式。 - 查看 Call Stack,应能看到
calculateDiscount由main调用;如果错误值来自更深层函数,就沿栈向上检查最早传入异常数据的调用者。

用单步执行确认错误传播
停在 rate 这一行后按 Step over。执行结束时,rate 会变成 undefined;再执行下一行,total 会变成 NaN。这两个相邻变化能把根因缩小到一次属性读取,而不是把注意力浪费在 console.log 或函数返回阶段。
如果断点停得太晚,可在 Call Stack 中选择上层帧,检查调用者传入的参数;如果错误偶发,可把条件断点设置为 user.level !== user.level.toLowerCase(),只在数据不符合约定时暂停,避免每次请求都中断。
修复后重新运行验证
修复时不要只给 undefined 一个默认费率把问题吞掉,而应先把输入规范化,再对未知等级显式报错。下面是替换 calculateDiscount 中费率读取部分的片段示例,依赖前面的 rates 对象与 user 参数。
const level = user.level.toLowerCase();
if (!(level in rates)) {
throw new Error(`Unknown user level: ${user.level}`);
}
const rate = rates[level];保存修改后关闭调试会话,正常运行程序验证结果。这样可以确认修复不仅让断点里的变量正确,也恢复了最终业务输出。
node debug-demo.js预期输出:
{ total: 160 }当问题发生在初始化阶段时优先用 --inspect-brk,发生在长时间运行的服务里则用 --inspect 后再附加。定位顺序始终从“错误结果”回到“错误值第一次出现的语句”,再用调用栈确认是谁把异常数据传进来。