Node.js 在 CentOS 上如何进行故障排查

Node.js 在 CentOS 上的故障排查步骤

一 快速定位与日志收集

• 查看应用输出与日志：实时跟踪日志，优先使用应用日志文件与标准输出重定向；若通过 systemd 托管，使用 journalctl 查看服务日志。示例：tail -f logs/app.log、journalctl -u your-nodejs-service -f。
• 检查运行环境：确认 Node.js 版本 与依赖一致（node -v、npm -v、npm install），并核对必要的 环境变量 是否设置。
• 网络连通性：确认端口监听与连通，排查 防火墙/安全组 策略是否阻断访问。
• 最小化复现：在本地或测试环境用相同代码与数据复现，便于快速定位。

二 常见错误与修复对照表

三 运行环境与依赖检查

• 版本与依赖：核对 Node.js/npm 与应用兼容；执行 npm ci（或 npm install）确保依赖一致；必要时使用 nvm 管理多版本。
• 权限与路径：确保运行用户对代码目录、日志目录具备读写权限；避免以 root 直接运行业务进程，建议使用专用用户并通过 systemd 或 PM2 管理。
• 端口与防火墙：确认监听地址与端口正确，放通 firewalld/安全组 规则；避免端口冲突。
• 环境变量：核对 NODE_ENV、数据库连接串、密钥等是否齐全且生效。

四 性能与资源瓶颈定位

• 系统层监控：使用 top/htop、nmon/atop、glances 观察 CPU、内存、I/O；安装 sysstat 后用 sar 查看历史与实时指标（如 sar -u 1、sar -r 1）。
• 进程与网络：用 pm2 monit 或 ps aux | grep node 定位高占用进程；用 nethogs/iftop 查看进程/网卡带宽。
• 日志分析：在 journalctl 或应用日志中检索 error/timeout/ECONNRESET 等关键字，结合时间戳与请求链路定位瓶颈。
• 可视化与告警：搭建 Prometheus + Grafana 采集 Node/系统指标并配置阈值告警；或使用 ELK/Splunk 集中化日志检索与可视化。

五 调试与事后复盘

• 调试手段：使用 node inspect 或 VS Code 远程调试设置断点；对异常分支补充日志与 try-catch/Promise.catch()/EventEmitter error 处理。
• 动态追踪：必要时用 strace/perf/systemtap/eBPF 跟踪系统调用与热点函数，定位难以复现的问题。
• 运行方式建议：生产环境优先使用 PM2 或 systemd 托管，开启 自动重启 与 日志轮转，便于故障自愈与取证。
• 变更留痕：记录 Node/npm 版本、依赖锁文件、系统/内核参数 与变更单，便于回溯与复盘。