Grunt CLI搭配npm时java包导致文件变更后服务器重启失败问题

我之前也踩过这个坑，npm的java包因为依赖JVM的Native绑定，很容易在进程重启时留下"僵尸"进程占用端口，导致Error: listen EADDRINUSE。下面是排查思路和具体解决方法：

问题根源分析 #

• JVM资源未被清理：java包会启动一个独立的JVM实例，当Grunt重启Node服务器时，如果旧进程没有显式关闭JVM，这个JVM会在后台持续运行，甚至持有端口连接，导致新进程无法绑定同一端口。
• Grunt重启机制未覆盖子进程：Grunt的watch或nodemon插件默认可能只终止主Node进程，但java包启动的JVM是独立的子进程，不会被自动杀死，继续占用端口资源。
• 服务器关闭逻辑不完整：你的Node服务器可能没有处理终止信号（比如SIGTERM/SIGINT），导致服务器关闭时没有主动清理java相关的Native资源。

具体解决步骤 #

1. 先确认端口占用的进程 #

首先验证是不是JVM进程在占用端口：

• Mac/Linux：运行lsof -i :<你的服务器端口>，查看输出里的进程名，如果有java或相关进程，说明旧JVM没被杀死。
• Windows：运行netstat -ano | findstr :<你的服务器端口>，找到进程ID（PID），然后用tasklist | findstr <PID>查看进程名。

2. 完善服务器的退出清理逻辑 #

在你的Node服务器代码中，添加信号监听，确保退出时关闭JVM和HTTP服务器：

const java = require('java');
const http = require('http');

const server = http.createServer((req, res) => {
  // 你的服务逻辑
});

const PORT = 3000;
server.listen(PORT, () => {
  console.log(`Server running on port ${PORT}`);
});

// 处理终止信号，确保清理资源
function cleanupAndExit() {
  console.log('Shutting down server and JVM...');
  // 先关闭HTTP服务器
  server.close(() => {
    // 显式关闭JVM（不同版本的java包可能方法名略有差异，可查文档确认）
    java.shutdownJVM();
    console.log('Resources cleaned up. Exiting...');
    process.exit(0);
  });
}

// 监听SIGTERM（Grunt/nodemon发送的终止信号）和SIGINT（Ctrl+C）
process.on('SIGTERM', cleanupAndExit);
process.on('SIGINT', cleanupAndExit);

3. 配置Grunt确保杀死整个进程树 #

如果使用grunt-nodemon，在配置里指定发送SIGTERM信号，触发你的清理逻辑：

module.exports = function(grunt) {
  grunt.initConfig({
    nodemon: {
      dev: {
        script: 'server.js',
        options: {
          killSignal: 'SIGTERM', // 发送SIGTERM信号而不是默认的强制杀死，给清理逻辑留时间
          watch: ['src/**/*.js']
        }
      }
    }
  });

  grunt.loadNpmTasks('grunt-nodemon');
  grunt.registerTask('default', ['nodemon']);
};

如果是自定义的watch任务，建议使用tree-kill包来杀死整个进程树，避免遗漏JVM子进程：
先安装依赖：

npm install tree-kill --save-dev

然后在Gruntfile里配置：

const treeKill = require('tree-kill');

// 保存服务器进程的PID
let serverProcess;

grunt.registerTask('start-server', function() {
  const done = this.async();
  serverProcess = require('child_process').fork('server.js');
  serverProcess.on('exit', done);
});

grunt.registerTask('restart-server', function() {
  const done = this.async();
  if (serverProcess) {
    // 杀死整个进程树，包括JVM子进程
    treeKill(serverProcess.pid, 'SIGTERM', (err) => {
      if (err) console.error('Failed to kill server process:', err);
      grunt.task.run('start-server');
      done();
    });
  } else {
    grunt.task.run('start-server');
    done();
  }
});

4. 临时应急方案 #

如果需要快速恢复开发，可以手动释放端口：

• Mac/Linux：kill -9 $(lsof -t -i :<端口号>)
• Windows：taskkill /F /PID <进程ID>（进程ID从netstat命令获取）

总结 #

最核心的是确保Node进程退出时显式关闭JVM，同时让Grunt的重启逻辑正确终止所有相关子进程。这样就能避免旧的JVM进程占用端口，导致重启时的EADDRINUSE错误。

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