Node Express服务器绑定192.168.0.90:3000时返回EADDRNOTAVAIL错误

问题重现 #

运行以下Express代码时触发错误：

app.listen("3000", "192.168.0.90", () => {
   console.log(`Server running at http://${hostname}:${PORT}/`);
});

返回错误信息：

Error: listen EADDRNOTAVAIL: address not available 192.168.0.90:3000
    at Server.setupListenHandle [as _listen2] (node:net:1723:21)
    at listenInCluster (node:net:1788:12)
    at doListen (node:net:1937:7)
    at process.processTicksAndRejections (node:internal/process/task_queues:83:21)
Emitted 'error' event on Server instance at:
    at emitErrorNT (node:net:1767:8)
    at process.processTicksAndRejections (node:internal/process/task_queues:82:21) {
  code: 'EADDRNOTAVAIL',
  errno: -4090,
  syscall: 'listen',
  address: '192.168.0.90',
  port: 3000
}

尝试改为监听0.0.0.0后问题依旧，已完成3000端口转发，需要通过[IP]:3000访问页面。

排查与解决步骤 #

1. 确认本地实际绑定的IP #

EADDRNOTAVAIL错误说明192.168.0.90并非当前机器实际拥有的IP地址。执行对应命令查看本地网卡IP：

• Windows：ipconfig
• Linux/macOS：ifconfig 或 ip addr

找到机器真实的内网IP（通常为192.168.x.x或10.x.x.x段），替换代码中的IP地址。

2. 验证0.0.0.0监听的服务状态 #

改为0.0.0.0后，先确认服务是否正常启动：

• 查看控制台是否输出Server running日志，若无则检查端口占用：
  • Windows：netstat -ano | findstr :3000
  • Linux/macOS：lsof -i :3000 或 netstat -tulpn | grep :3000
• 若端口被占用，杀掉对应进程后重启服务；若端口空闲，继续下一步。

3. 测试本地访问有效性 #

在运行服务的机器上，用浏览器或curl访问http://localhost:3000和http://[实际内网IP]:3000，若都能访问，说明服务本身无问题，故障出在网络层面。

4. 排查防火墙与端口转发规则 #

• 本地防火墙：确认机器防火墙允许3000端口入站连接：
  • Windows：在Windows Defender防火墙中添加3000端口的入站规则
  • Linux：执行ufw allow 3000（使用ufw时）或配置iptables规则
  • macOS：在系统设置-网络-防火墙中允许应用通过3000端口通信
• 路由器端口转发：检查规则正确性：
  • 确认转发的是内网IP的3000端口到公网3000端口
  • 协议选择TCP（HTTP基于TCP）
  • 部分路由器需重启生效，重启后再测试
• 公网IP限制：若使用公网IP访问，确认是否为运营商NAT后的共享IP（无独立公网IP），这种情况端口转发无效，需使用内网穿透工具（如ngrok）。

5. 检查代码变量定义 #

注意日志中使用的${hostname}和${PORT}变量，确保已正确定义：

const hostname = '0.0.0.0'; // 或实际内网IP
const PORT = 3000;

app.listen(PORT, hostname, () => {
   console.log(`Server running at http://${hostname}:${PORT}/`);
});

若变量未定义，日志会显示http://undefined:undefined/，误导对监听地址的判断。

6. 用简化代码测试服务 #

使用最简代码排除中间件或路由的影响：

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Hello World!');
});

const PORT = 3000;
app.listen(PORT, '0.0.0.0', () => {
  console.log(`Server running at http://0.0.0.0:${PORT}/`);
});

启动后重复本地访问测试，再尝试外部访问。

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