Node.js Express提示端口占用无对应进程 目录出现端口号文件如何解决

你目录下出现的端口号命名文件是Unix域套接字文件，这是问题的核心诱因：

• Node.js的server.listen方法如果接收的参数是字符串，会将其识别为Unix域套接字的存储路径，创建对应名称的文件进行监听，而非监听TCP网络端口。
• 你使用的lsof -i、netstat等命令默认仅查询TCP/UDP网络端口，无法检测到Unix域套接字的占用，因此找不到对应的运行进程。
• 首次启动时目录下无对应名称的文件，服务可以正常创建套接字运行；服务关闭时套接字文件未被自动清理，下次启动检测到文件已存在，就会抛出和TCP端口占用完全一致的EADDRINUSE错误。

触发这个逻辑的原因在你的normalizePort函数：当传入的端口值转换为数字失败返回NaN时，函数会直接返回原始字符串作为命名管道路径，大概率是你配置的process.env.PORT携带了非数字字符（空格、换行、特殊符号等），导致parseInt转换失败。

1. 先删除当前目录下残留的套接字文件

rm -f ./3000 ./3002 ./3003

2. 优化normalizePort函数逻辑，避免误判为套接字路径，只有合法的端口数字才会被返回，否则直接使用默认端口：

function normalizePort(val) {
  var port = parseInt(val, 10);
  // 仅返回合法的端口数字，不返回字符串避免触发Unix套接字逻辑
  if (!isNaN(port) && port >= 0 && port <= 65535) {
    return port;
  }
  return 3001; // 此处替换为你的默认端口
}

3. 检查环境变量PORT的配置方式，确保传入的是纯数字字符串，无多余字符。不同环境的启动示例：

# Mac/Linux 环境启动命令
PORT=3000 node ./bin/www

# Windows cmd 环境启动命令
set PORT=3000 && node ./bin/www

# Windows PowerShell 环境启动命令
$env:PORT=3000; node ./bin/www

4. 后续如果需要排查Unix域套接字占用，可使用以下命令：

lsof -U | grep 【端口号/套接字文件名】

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