Node.js在CentOS上的错误怎样排查

1. 首先查看错误日志

排查Node.js问题时，错误日志是最关键的线索，可以通过以下途径获取：

• 若应用已经设置日志输出，可先检查其自身生成的日志（如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 <PID>终止进程，或修改应用端口（如将3000改为3001）。
• 特权端口：若使用80、443等特权端口，需用sudo运行应用（如sudo node app.js），或修改端口为非特权端口（≥1024）；长期方案可通过setcap赋予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阻止操作。临时禁用SELinux测试（sudo setenforce 0），若问题解决，可修改/etc/selinux/config文件（将SELINUX=enforcing改为SELINUX=disabled）永久禁用，或配置SELinux策略（如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更新到最新版本（注意检查更新日志，避免破坏性变更）。