Node.js升级至18.16.0后出现无堆栈追踪的[Error: Invalid argument]未捕获异常，求排查方案

API 探路者

2026-4-22

升级Node.js大版本（从10到18）+ 全量更新依赖确实容易踩兼容性坑，无堆栈的异常排查起来更是头疼。结合你的环境和问题描述，给你几个实际可行的排查方向：

强制捕获并输出完整异常细节
有时候Node默认的uncaughtException输出会丢失堆栈或附加信息，你可以在项目入口文件（比如app.js最开头）手动添加监听，强制打印完整错误对象：

const util = require('util');
const fs = require('fs');

process.on('uncaughtException', (err) => {
  const errorDetails = `Uncaught Exception:\n${util.inspect(err, { depth: null, showHidden: true })}\n\nStack Trace:\n${err.stack || 'No stack trace available'}`;
  console.error(errorDetails);
  // 写入文件避免控制台日志丢失
  fs.writeFileSync('uncaught-error.log', errorDetails, 'utf8');
  process.exit(1);
});

// 别忘了监听未处理的Promise拒绝，Node 18对这类场景的处理更严格
process.on('unhandledRejection', (reason, promise) => {
  console.error(`Unhandled Rejection at Promise: ${promise}\nReason: ${util.inspect(reason)}`);
});

这样即使异常没有默认堆栈，也能尽可能拿到错误的附加属性、触发上下文等信息。

逐步排查版本兼容性
1. 先临时回退Node.js到16.x LTS版本，如果异常消失，说明问题和Node 18的API/底层变化直接相关；如果仍出现，大概率是某个依赖包更新后的兼容性问题。
2. 逐个回退可疑依赖：看你的package.json，node-sspi（版本0.2.10较老旧，Windows环境下调用系统SSPI，很可能和Node 18的libuv不兼容）、tedious-connection-pool2、cookie-session这些和系统、网络、会话相关的包是重点排查对象，可以先回退到Node 10时期兼容的版本，验证是否解决问题。
启用Express详细调试日志
Express支持通过DEBUG环境变量打印完整的请求处理流程，包括中间件调用顺序、路由匹配等细节。Windows环境下启动项目时执行：
```
set DEBUG=express:* && node app.js
```
这样能看到请求从进入到处理的每一步，当异常触发时，对照日志就能定位到最后执行的中间件/路由环节，缩小排查范围。
排查闲置资源的异常触发逻辑
你提到页面闲置一段时间后更容易触发异常，这大概率和资源闲置超时有关：
- 检查tedious-connection-pool2的配置，比如闲置连接的回收策略，是否在连接闲置后重新使用时出现参数错误；
- 检查cookie-session的配置，是否会话存储在闲置后出现失效或参数异常；
- 可以尝试临时关闭闲置资源的自动回收机制，看是否还会触发异常，反向验证问题点。
临时禁用可疑中间件
比如先注释掉node-sspi相关的中间件，再测试页面加载。如果异常消失，就确定是这个包的问题，可以尝试寻找它的Node 18兼容版本，或者替换成其他Windows身份验证的替代包。

备注：内容来源于stack exchange，提问作者Mathieu