Ubuntu JS日志中的错误码代表什么含义

Ubuntu 环境下 JS 日志错误码含义与处理

一 错误码分类与含义

• JavaScript 运行时错误类型：这类是语言层面的异常名称，并非数字码，但在日志中最常见。包括：SyntaxError（语法错误）、TypeError（类型错误）、ReferenceError（引用未定义）、RangeError（数值或长度越界）、URIError（URI 编解码参数非法）、EvalError（eval 相关，ES5 后基本不再抛出）。它们用于指示代码在解析或执行阶段出现的具体问题类型。
• Node.js 系统错误码：当 JS 运行在 Node.js 中，日志里常出现以 E 开头的系统错误码，表示底层资源或网络问题，例如：EADDRINUSE（端口被占用）、EACCES（权限不足）、EADDRNOTAVAIL（地址不可用）、ENOENT（文件或目录不存在）、ETIMEDOUT（连接超时）。这些错误码来自操作系统或网络栈，与具体业务逻辑无关，但直接影响程序可用性。

二 常见错误码与修复建议

三 定位与排查步骤

• 确认运行环境：是 浏览器 前端 JS，还是 Node.js 后端；两者的错误码体系不同（前端多为语言异常名，后端常见系统错误码）。
• 提取关键信息：关注日志的时间戳、日志级别（error/warn/info/debug）、错误码/异常名、堆栈跟踪（stack trace）与上下文（函数名、文件与行号）。
• 复现与最小化：在本地或测试环境用最小代码片段复现问题，便于快速定位根因。
• 针对性处理：
  • 若为 EADDRINUSE：lsof -i :端口 或 ss -ltnp | grep :端口 找到占用进程并 kill；或改用未占用端口。
  • 若为 EACCES：检查目标文件/目录权限与所属用户组，必要时 chmod/chown 或以合适用户运行。
  • 若为 ENOENT：核对相对/绝对路径与工作目录，确认文件已创建。
  • 若为语言异常（如 SyntaxError/TypeError）：依据堆栈定位到具体文件与行号，修正代码逻辑与类型使用。

四 日志最佳实践

• 统一结构与级别：在日志中规范输出时间戳、级别、错误码/异常名、消息、堆栈、上下文，便于检索与聚合分析。
• 使用成熟日志库：如 Winston、Bunyan，支持多级别、结构化输出与多种传输方式，提升可观测性。
• 增加上下文信息：在日志中记录关键变量、请求 ID、用户 ID、调用链标识，缩短定位路径。
• 避免吞掉错误：在异步与 Promise 链中使用 .catch() 或 try/catch，确保错误被记录并可告警。