Node.js启动server.js时触发Segmentation fault错误求助

问题背景 #

修改server.js并推送到GitHub后，在服务器执行git stash --all和gh repo sync同步，因本地server.js存在改动无法恢复stash，忽略该问题后重新下载依赖、配置.env文件，随后启动服务器或安装Node模块出现异常（无具体报错信息）。通过sudo apt autoremove卸载Node.js和npm后，重新安装时默认获取了Node.js 12版本，重新配置apt源后安装了目标版本，但执行node server.js时程序长时间加载后返回Segmentation fault，node -v等基础命令可正常运行。已尝试重启服务器、检查版本、权限、更换文件路径等操作，问题未解决。

排查与解决步骤 #

1. 修复代码与依赖环境 #

• 从GitHub拉取干净的server.js版本，替换本地可能存在异常的文件，避免未恢复的stash内容或本地修改导致代码逻辑错误
• 彻底清理依赖并重新安装：

  rm -rf node_modules package-lock.json
  npm cache clean --force
  npm install
  

• 校验.env文件：确认所有环境变量格式正确，无引号不匹配、缺失必填项等语法问题

2. 确保Node.js安装完整无残留 #

• 彻底卸载并清理Node.js相关文件：

  sudo apt purge nodejs npm -y
  sudo rm -rf /usr/local/lib/node_modules
  sudo rm -rf ~/.npm
  sudo rm -rf /etc/apt/sources.list.d/nodesource.list
  

• 重新配置目标版本的Node.js apt源（以Node.js 20为例，可根据项目需求替换版本号）：

  curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
  sudo apt-get install -y nodejs
  

• 验证安装有效性：

  node -v
  npm -v
  npm list -g --depth=0
  

3. 定位Segmentation fault根源 #

• 查看系统内核日志获取崩溃详情：

  dmesg | grep -i segfault
  

  该命令会输出内核记录的崩溃信息，可定位是Node.js本身还是特定依赖模块导致的问题
• 测试基础Node.js运行能力：创建test.js文件，内容如下，执行node test.js验证Node.js能否正常执行代码

  console.log("Node.js runtime test");
  const http = require('http');
  const server = http.createServer((req, res) => {
    res.statusCode = 200;
    res.setHeader('Content-Type', 'text/plain');
    res.end('Test server running successfully\n');
  });
  server.listen(3000, () => {
    console.log('Test server listening on port 3000');
    server.close();
  });
  

• 修正项目文件权限：确保Node.js拥有项目目录及文件的读写权限

  sudo chown -R $USER:$USER /path/to/your/project
  chmod -R 755 /path/to/your/project
  

4. 排查依赖兼容性问题 #

• 核对package.json中engines字段，确认当前安装的Node.js版本符合项目要求
• 逐步排查可疑依赖：如果基础测试脚本正常运行，说明问题出在项目依赖中，可尝试临时移除最近新增的依赖模块，逐个测试定位导致崩溃的模块

内容的提问来源于stack exchange，提问作者Kasumi