Node.js日志中常见的错误有哪些

Node.js 日志中常见的错误与排查要点

一 运行时与代码错误

• SyntaxError / ReferenceError / TypeError：语法错误、引用未定义变量、对不适当类型执行操作，常见于启动阶段或热更新后。
• Uncaught Exception / Unhandled Rejection：未捕获的异常或未处理的 Promise 拒绝，常导致进程崩溃，应在全局监听并妥善记录堆栈。
• 流未处理 error 事件：如文件/网络流未监听 error，错误会在事件循环传播并引发崩溃。
• 内存不足（JavaScript heap out of memory）：大数据集、内存泄漏或缓存滥用导致，需要排查泄漏与优化内存占用。
• 回调多次调用或错误调用：done/回调被多次或错误调用，引发状态不一致或异常。
• 环境/依赖兼容性错误：Node 版本或依赖包不一致导致启动或运行期报错。
• 权限错误（EACCES）：访问受限资源失败，如写日志文件、创建目录或安装原生模块时权限不足。

二 网络与进程错误

• EADDRINUSE：端口被占用，常见于服务重启未释放端口或并行实例冲突。
• EADDRNOTAVAIL：绑定的 IP 不可用，如配置为不存在或未启用的网卡地址。
• ECONNREFUSED：目标服务未启动、端口错误或防火墙拦截导致连接被拒绝。
• ETIMEDOUT / ERR_TIMEOUT：连接或请求超时，常见于下游服务慢、网络抖动或超时阈值过低。
• HTTP/2 协议错误（ERR_HTTP2_PROTOCOL_ERROR）：HTTP/2 配置或实现不兼容引发。
• 无效响应（ERR_INVALID_RESPONSE）：下游返回不符合协议/解析预期的响应。

三 文件与路径错误

• ENOENT：no such file or directory：读取/写入的文件或目录不存在，常见于配置路径错误、资源未就绪或打包产物缺失。
• EACCES：permission denied：无权限读取/写入文件或目录，常见于日志目录、证书文件或用户目录权限不足。

四 日志配置与输出错误

• 日志目录/文件不可写：如尝试写入 /var/log/node.log 但当前用户无写权限，导致日志丢失或应用异常。
• 日志格式不统一：缺少时间戳、日志级别、消息等关键字段，影响检索与聚合分析。
• 缺少日志轮转与归档：日志文件无限增长，磁盘被占满，影响服务稳定性。
• 未记录堆栈与上下文：仅打印消息，缺少错误堆栈、请求 ID、用户/租户等上下文，难以定位根因。

五 快速排查与修复建议

• 端口占用：使用命令查看并释放端口，例如：lsof -i :3000 或 ss -ltnp | grep 3000，随后 kill -9 ；必要时更换端口。
• 模块缺失：确认依赖已安装且版本匹配，执行 npm/yarn install，检查 node_modules 与 package.json 一致性。
• 权限问题：为日志目录与证书文件设置合适权限（如日志目录 0755、文件 0644），或以具备权限的用户运行；避免全局安装时权限过度放宽。
• 地址不可用：核对绑定 IP 与网卡配置，避免使用未启用的地址（如误用公网 IP 或 Docker 内部地址）。
• 连接问题：验证下游服务是否可达与监听正确端口，检查防火墙/安全组与网络延迟，适当增大超时阈值。
• 内存不足：用 –inspect 或内存分析工具定位泄漏，优化查询/缓存，分批处理大数据，必要时增加容器/实例内存。
• 流与异步错误：为所有流添加 error 监听；统一用 Promise/async-await 并全局处理 unhandledRejection；回调严格保证单次调用。
• 日志治理：使用 winston/morgan 等库统一格式（含 timestamp、level、message），输出到控制台与滚动文件，关键错误单独落盘并保留堆栈与上下文。