Node.js在CentOS上的错误如何排查

1. 查看错误日志——这是排查的第一步

错误日志是定位问题的核心线索，怎么获取？两种途径：

• 应用自己的日志：如果项目里配置了日志输出（比如输出到logs/app.log），直接用tail -f /path/to/app.log就能实时看到最新错误。更省心的做法是启动时就把输出重定向到文件，例如node app.js >> logs/app.log 2>&1 &，这样事后分析也方便。
• 系统日志：通过journalctl命令查看与Node.js服务相关的日志（记得指定服务名，比如journalctl -u my-nodejs-app -t）。或者直接翻CentOS的系统日志——/var/log/messages和/var/log/syslog，有时候系统级别的错误线索就藏在这里。

2. 检查Node.js与npm安装

• 验证安装：运行node -v和npm -v，如果提示“command not found”，说明要么没装好，要么路径没配。
• 修复路径问题：已经装了但系统不认？把Node.js可执行文件路径加到PATH环境变量里，比如export PATH=/usr/local/node/bin:$PATH，然后重新打开终端生效。或者用nvm（Node Version Manager）来管理多版本——先curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash，再nvm install node，一步到位。

3. 处理依赖项问题

• 安装缺失依赖：如果看到“Error: Cannot find module ‘xxx’”，说明依赖没装全。直接npm install xxx安装指定模块；或者干脆删掉node_modules文件夹和package-lock.json，重新npm install，能解决大部分依赖冲突。
• 全局依赖检查：有些依赖需要全局安装（比如nodemon），那就用npm install -g xxx。装完后确保全局路径（比如/usr/local/lib/node_modules）在PATH里，否则系统找不到。

4. 解决端口相关错误

• 端口占用：启动时报“Error: listen EADDRINUSE :::3000”，说明端口被占用了。用netstat -tuln | grep 3000看看是谁占的，然后kill -9 把它干掉；或者直接改应用端口，比如把3000换成3001。
• 特权端口：如果要用80、443这类特权端口，得用sudo启动应用（比如sudo node app.js），或者干脆换个非特权端口（≥1024）。长期方案是给Node.js赋予绑定特权端口的权限：sudo setcap 'cap_net_bind_service=+ep' /usr/local/bin/node。

5. 检查文件与目录权限

• 权限不足：出现“EACCES”或“ENOENT”错误（比如读不了配置文件、写不了日志），多半是权限问题。用chmod -R 755 /path/to/directory赋予读写执行权限，或者chown -R user:group /path/to/directory修改所有者，例如chown -R centos:centos /var/www/app。

6. 验证系统资源是否充足

• 资源不足：应用崩溃或响应慢？先看看资源。用top查看CPU和内存使用率——内存占用过高就需要优化代码或增加内存。用df -h检查磁盘空间，确保/分区还有余量。用free -m查看内存使用情况，如果内存紧张，可以调整swappiness值或增加交换分区。

7. 调整SELinux设置（若启用）

• SELinux拦截：如果权限正常却还报“Permission denied”，很可能是SELinux在捣乱。先临时禁用测试一下：sudo setenforce 0。如果问题解决，可以永久禁用（修改/etc/selinux/config，将SELINUX=enforcing改为SELINUX=disabled），或者用audit2allow生成自定义规则，更精细地放行。

8. 使用调试工具定位问题

• 内置调试器：用node inspect app.js启动调试模式，然后在Chrome浏览器打开chrome://inspect连接，设置断点、逐步执行代码，查看变量值和调用栈。
• VS Code调试：创建.vscode/launch.json文件，配置"type": "node"、"program": "app.js"等参数，然后通过VS Code的调试面板启动。支持条件断点、变量监视，比人工打日志快得多。

9. 检查代码语法与逻辑

• 语法错误：用代码编辑器（比如VS Code）的语法检查功能，或者运行npm run lint（如果配置了ESLint）检查代码风格和潜在错误。修复语法错误（比如缺少括号、引号）后重新启动应用。
• 逻辑错误：通过console.log输出关键变量值，或者在代码里加debugger语句暂停执行，逐步排查逻辑问题，比如异步回调没执行、数据库查询失败等。

10. 更新系统与依赖

• 系统更新：运行sudo yum update -y更新CentOS系统包，修复潜在的安全漏洞和兼容性问题。
• 依赖更新：用npm outdated查看哪些依赖过时了，然后npm update更新到最新版本。注意先看更新日志，避免破坏性变更。