Debian JS日志中错误码含义是什么

Debian 环境下 JS 日志常见错误码与含义

一 通用 JavaScript 运行时错误类型

• SyntaxError：语法不合法，如缺少括号、引号不匹配、缺少分号等，通常在应用启动或代码动态执行阶段抛出。
• ReferenceError：访问了未声明或未初始化的变量。
• TypeError：对值执行了不适用的操作，例如把字符串当作函数调用、对 null/undefined 取属性。
• RangeError：数值或参数超出允许范围，例如递归过深、数组长度为负等。
• URIError：encodeURI / decodeURI 等处理非法 URI 时抛出。
• EvalError：与 eval 使用不当相关，现代代码中较少见。
  这些名称本身就是“错误码/错误类型”，日志通常会伴随堆栈与位置信息，便于定位文件与行列号。

二 Node.js 常见错误码与含义

• EADDRINUSE：端口被占用，应用尝试监听的 IP:端口 已被其他进程使用。
• Error: Cannot find module：依赖模块未安装或路径错误，常见于 require/import 失败。
• Uncaught Exception / UnhandledPromiseRejection：未捕获的异常或未处理的 Promise 拒绝，可能导致进程退出。
• Error: Timeout：操作超时，可能由网络延迟、数据库慢查询或外部接口响应慢引起。
• JavaScript 堆内存不足（如 FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory）：内存泄漏或单次处理数据量过大。
• 流未处理的错误（如未监听 stream.on(‘error’)）：流读写异常未被捕获，可能在事件循环中传播并导致崩溃。
• 环境/兼容性问题：Node.js 版本或依赖库不兼容导致的行为差异或 API 不可用。
  以上错误在 Debian 上的 Node.js 应用中非常常见，日志中通常包含错误名称、消息与堆栈跟踪。

三 业务系统自定义错误码说明

• 许多企业系统会在 JS/Node.js 日志中输出自定义错误码（如：xnaa0201x005、xcca02010004、yala04212007 等），这些码只在对应系统/接口文档中有定义。
• 含义与处理建议需查阅该系统的接口/错误码手册或联系后端/系统管理员确认，通用文档通常无法直接解释。
• 若日志中仅出现此类码而无上下文，建议同时抓取请求参数、调用链标识与时间戳，便于快速定位。

四 在 Debian 上快速定位与排查

• 定位日志文件：系统级日志可查看 /var/log/syslog，Node.js 应用常写入应用目录的 logs/ 或通过 journalctl 查看（如：journalctl -u yourapp.service -f）。
• 关键字检索：
  • grep ‘SyntaxError|TypeError|ReferenceError’ /var/log/syslog
  • grep -i ‘EADDRINUSE|Cannot find module’ /var/log/yourapp.log
• 修复与验证：
  • 语法/引用/类型错误：修正代码与依赖，必要时增加 try-catch 与静态检查。
  • EADDRINUSE：更换端口或结束占用进程（如 ss -ltnp | grep :PORT 后 kill）。
  • Cannot find module：执行 npm/yarn 安装或校正模块路径。
  • 内存不足：排查泄漏、优化批处理大小、必要时调大 –max-old-space-size。
  • 未捕获异常：全局监听 uncaughtException/unhandledRejection 并记录与优雅退出。
  • 修复后重启服务：如 sudo systemctl restart yourapp 或 pm2 restart yourapp。