Node.js与Java Socket实现报错：connect ECONNREFUSED 127.0.0.1:8081

嘿，这个错误我太熟了！咱们先拆解一下问题：你看到的ECONNREFUSED 127.0.0.1:8081本质就是Node.js客户端找不到在这个端口上监听的Java服务，直接被拒绝连接了。下面是一步步排查和解决的方法：

1. 先确认Java Socket服务真的在运行 #

这是最常见的原因——你以为服务启动了，但其实没起来，或者监听的端口/IP不对：

• 检查Java服务端代码：确保ServerSocket的初始化是正确的，比如是不是写了new ServerSocket(8081)（如果要绑定指定IP，得用new ServerSocket(8081, 50, InetAddress.getByName("127.0.0.1"))），有没有拼写错误的端口号？
• 用命令行验证端口监听：
  • Windows：打开命令提示符，运行 netstat -ano | findstr :8081，如果没有输出，说明这个端口完全没被监听，Java服务肯定没起来。
  • Linux/macOS：终端运行 lsof -i :8081 或者 netstat -tulpn | grep 8081，同样，无输出=服务未启动或端口错误。

2. 核对Node.js客户端的连接参数 #

别笑，很多时候都是手滑写错了：

• 确保Node.js里的连接地址是127.0.0.1，端口是8081，和Java服务端的监听配置完全一致。比如有没有把端口写成8080、8181这类相似的数字？

3. 排查本地防火墙/安全软件 #

有时候本地防火墙或者杀毒软件会拦截本地的Socket连接，尤其是刚装的安全工具：

• 暂时关闭防火墙或杀毒软件，再试一次连接。如果能连上了，记得给你的Java服务和Node.js程序添加防火墙允许规则，避免下次再被拦截。

4. 给Node.js客户端加上错误监听 #

你的错误日志里提到了Unhandled 'error' event，这说明你的客户端代码没有处理Socket的错误事件，导致错误直接抛出崩溃。赶紧补上这个监听，不仅能避免崩溃，还能拿到更清晰的错误信息：

const net = require('net');
const client = new net.Socket();

// 连接到Java服务
client.connect(8081, '127.0.0.1', () => {
  console.log('成功连接到Java服务端！');
});

// 必须添加的错误监听
client.on('error', (err) => {
  console.error('连接出错：', err.message);
  // 可以在这里做重连或者其他处理
});

额外提示 #

• 如果你的Java服务是在Docker之类的容器里运行，一定要确认端口映射配置正确——把容器内的8081端口映射到宿主机的8081端口，不然Node.js连的是宿主机端口，容器里的服务根本接收不到。
• 有时候进程残留会导致端口被占用或者服务没正确启动，试试完全关闭Java服务和Node.js客户端，然后重新启动。

内容的提问来源于stack exchange，提问作者Parvathy.P.B