带C++原生模块的Node.js Docker容器SIGSEGV后无法重启求解决方案

我之前也踩过一模一样的坑——Node.js应用因为C++原生模块触发SIGSEGV崩溃，但明明Docker Compose里设了restart: always，容器就是不自动重启。问题其实出在容器的主进程身上，我给你一步步拆解：

问题根源 #

你现在用CMD [ "npm", "start" ]启动应用，这时候npm是容器的PID 1进程，Node.js只是它的子进程。当Node.js因为段错误崩溃时，npm并不会跟着退出（它会认为子进程异常但自己还能正常运行），Docker检测到主进程还在，就不会触发重启策略。

解决办法（按优先级排序） #

1. 直接启动Node.js进程（最推荐） #

修改Dockerfile里的CMD指令，绕过npm，直接用node命令运行你的入口文件。根据你的配置，入口应该是index.js，所以改成：

CMD [ "node", "index.js" ]

这样Node.js就变成了容器的PID 1进程，一旦它因为段错误崩溃，整个容器会立即退出，Docker的restart: always就会自动重启容器。亲测这个方法最直接有效。

2. 让npm在子进程崩溃时退出（如果一定要用npm start） #

如果你因为某些原因必须保留npm start的启动方式，可以修改package.json里的start脚本，用exec命令让node进程替换npm进程：

{
  "scripts": {
    "start": "exec node index.js"
  }
}

exec会让node进程接管npm的PID，同样成为容器的主进程，崩溃时容器会正常退出触发重启。

3. 补充：确认Docker重启策略的生效条件 #

你已经设置了restart: always，这个策略会在容器非正常退出（退出码非0）时触发重启。只要主进程在段错误时能正常退出（退出码通常是139，对应SIGSEGV），Docker就会执行重启。如果还是有问题，可以尝试换成restart: unless-stopped，这个策略覆盖的场景更全面，但核心还是要让主进程正确退出。

验证方法 #

修改完配置后，重新构建镜像并启动容器：

docker-compose build web
docker-compose up -d

然后进入容器找到Node.js的PID，发送SIGSEGV信号模拟崩溃：

# 找到容器ID
docker ps | grep web
# 进入容器
docker exec -it <container_id> bash
# 找到node进程PID
ps aux | grep node
# 发送段错误信号
kill -SIGSEGV <node_pid>

之后用docker ps查看容器状态，应该能看到容器自动重启了，也可以用docker logs <container_id>查看重启日志确认。

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