CentOS中Node.js错误如何排查

CentOS中Node.js错误排查指南

1. 查看错误日志

日志是定位错误的“第一线索”。Node.js应用的日志通常位于项目根目录（如logs/app.log）或系统日志中，可通过以下方式查看：

实时查看应用日志：使用tail -f /path/to/app.log命令跟踪日志输出，及时捕捉错误信息。
系统日志：若应用以服务形式运行（如通过systemd），可使用journalctl -u your-nodejs-service-name查看与服务相关的系统级错误。

2. 使用调试工具

调试工具能深入分析代码执行流程，快速定位问题根源：

内置调试器：通过node inspect app.js启动调试模式，支持断点、单步执行、变量查看等功能，默认会在浏览器中打开调试界面。
IDE集成：Visual Studio Code（VS Code）是常用选择，通过创建.vscode/launch.json文件配置调试参数（如端口号、路径映射），可直接在IDE中设置断点、查看调用栈。

3. 检查常见错误类型及解决方法

① 端口占用（EADDRINUSE）

错误表现：Error: listen EADDRINUSE :::3000（端口3000已被占用）。
解决方法：

查找占用端口的进程：lsof -i :3000，获取进程ID（PID）；
终止进程：kill -9 <PID>；
或更换端口号（如const port = process.env.PORT || 3001）。

② 模块未找到（Cannot find module）

错误表现：Error: Cannot find module 'express'（模块未安装或路径错误）。
解决方法：

安装缺失模块：npm install express；
若为本地模块，检查require路径是否正确（如./utils/helper而非utils/helper）；
删除node_modules目录并重新安装：rm -rf node_modules && npm install。

③ 语法错误（SyntaxError）

错误表现：SyntaxError: missing ) after argument list（括号不匹配、引号未闭合等）。
解决方法：

使用代码编辑器（如VS Code）的语法检查功能，提前发现错误；
仔细检查代码中的括号、引号、分号等符号是否完整。

④ 未捕获的异常（Uncaught Exception）

错误表现：程序突然崩溃，无错误提示或提示UnhandledPromiseRejectionWarning。
解决方法：

添加全局异常处理：process.on('uncaughtException', (err) => { console.error('未捕获异常:', err); process.exit(1); })；

对于Promise，必加.catch()或使用async/await配合try/catch：

// Promise模式
readFile('a.txt').then(data => console.log(data)).catch(err => console.error('读取失败:', err));

// async/await模式
try {
  const data = await readFile('a.txt');
  console.log(data);
} catch (err) {
  console.error('读取失败:', err);
}

4. 检查系统资源

资源不足会导致应用性能下降或崩溃，需通过以下命令排查：

CPU/内存：使用top或htop命令查看进程的CPU、内存占用，若占用过高，需优化代码（如拆分CPU密集型任务）或升级服务器配置。
磁盘空间：使用df -h命令查看磁盘剩余空间，若空间不足，清理无用文件（如日志、临时文件）。
I/O负载：使用iostat或cat /proc/{pid}/io查看磁盘I/O情况，若I/O过高，优化数据库查询或文件操作。

5. 管理依赖项

依赖冲突或未安装会导致应用运行异常，需注意：

安装依赖：进入项目目录，运行npm install安装package.json中定义的所有依赖。
更新依赖：使用npm update更新依赖包，修复已知漏洞；或使用npm audit检查安全漏洞。
解决冲突：若出现依赖版本冲突，使用npm ls <package-name>查看依赖树，手动指定兼容版本（如npm install lodash@4.17.21）。

6. 环境配置检查

环境变量未设置或路径错误会导致应用无法正常运行：

设置环境变量：在运行脚本前设置变量（如export API_KEY=your_key），或使用.env文件（需配合dotenv包加载）：
```
# .env文件
API_KEY=your_key
PORT=3000
```
```
// app.js
require('dotenv').config();
console.log(process.env.API_KEY); // 输出your_key
```
权限问题：若应用需要访问受限资源（如端口80、文件目录），需使用sudo提升权限（如sudo node app.js），或修改资源权限（如chmod 755 /path/to/dir）。

7. 使用第三方日志库

原生console.log难以满足复杂日志需求，可使用第三方库提升日志管理能力：

Winston：支持多传输方式（文件、控制台、数据库），适合生产环境。示例：

const winston = require('winston');
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' }),
    new winston.transports.Console({ format: winston.format.simple() }) // 开发环境输出到控制台
  ]
});
logger.info('Server started on port 3000');

Morgan：HTTP请求日志中间件，适合记录请求详情（如URL、状态码、响应时间）。

通过以上步骤，可系统性地排查CentOS上Node.js应用的错误。若问题仍未解决，建议查阅Node.js官方文档或在技术社区（如Stack Overflow）寻求帮助，提供详细的错误日志和代码片段以获取更精准的解决方案。