Node.js服务无法使用8080以外端口的问题求助

执行指定端口的启动命令后，服务依然绑定8080端口，命令示例：

$ npm start -- --port 3000

> movie-plus-server@1.0.0 start
> node src/index.js --port 3000

app is running in PORT: 8080

场景与已尝试的排查手段 #

• 运行环境：Windows
• 问题突发于频繁修改代码、手动重启服务（未使用nodemon）且未变更环境配置的场景
• 已尝试的无效操作：
  • 修改Dockerfile、docker-compose.yaml中的端口配置
  • 更换多个不同端口测试
  • 重装Node.js
  • 清除Docker数据
  • 在其他项目、新建基础项目中测试
  • 使用不同格式的端口参数
  • 配置.env文件指定端口

补充代码与配置 #

src/index.js 核心片段 #

const start = async () => {
    try {
        await connectDB();

        if (process.env.NODE_ENV !== "production") {
            require("dotenv").config({ path: path.join(__dirname, "../.env") });
        }

        // 其他业务代码

        const port = process.env.APP_PORT;

        // 其他业务代码

        app.listen(port, () => console.log(`app is running in PORT: ${port}`));

    } catch (err) {
        console.log(err);
        app.get("/health", (req, res) => {
            res.send({ "API Server": "NOT OK" });
        });
    }
};

.env 文件内容 #

NODE_ENV=staging
APP_PORT=5001
ME_PORT=8082
GMAIL_USER=something@gmail.com
GMAIL_PASSWORD=something
MONGODB_PORT=27017
MONGODB_USER=admin
MONGODB_HOST=mongodb
MONGODB_PASSWORD=password
MONGODB_DATABASE=cinema

问题根源与解决方案 #

核心问题1：代码未处理命令行传入的--port参数 #

当前代码仅读取process.env.APP_PORT环境变量，完全没有解析命令行传入的--port参数，所以无论你在命令行传什么端口，代码都不会生效。

解决方法：添加命令行参数解析逻辑

可以手动解析process.argv，或者使用yargs这类工具简化处理：

• 手动解析示例：

// 在定义port前添加这段代码
let port = process.env.APP_PORT;
const argv = process.argv.slice(2);
for (let i = 0; i < argv.length; i++) {
    if (argv[i] === '--port' && argv[i + 1]) {
        port = argv[i + 1];
        break;
    }
}

• 使用yargs工具：

1. 安装依赖：npm install yargs --save
2. 修改代码：

const argv = require('yargs').argv;
// ...
const port = argv.port || process.env.APP_PORT || 8080; // 增加默认值兜底

核心问题2：dotenv加载时机错误 #

当前代码在await connectDB()之后才加载.env文件，如果connectDB()依赖.env中的配置（比如MONGODB相关参数），会导致配置未生效；同时也可能导致process.env.APP_PORT读取不到正确值（如果代码执行到const port = process.env.APP_PORT时，dotenv还没加载完成）。

解决方法：提前加载dotenv

将dotenv的加载逻辑移到文件最顶部，或者至少在connectDB()之前：

// 文件顶部先加载dotenv
const path = require('path');
if (process.env.NODE_ENV !== "production") {
    require("dotenv").config({ path: path.join(__dirname, "../.env") });
}

const start = async () => {
    try {
        await connectDB();
        // ... 其余代码
    } catch (err) {
        // ... 错误处理
    }
};

额外排查点 #

1. 验证.env文件路径是否正确：在dotenv加载后添加console.log('Loaded APP_PORT:', process.env.APP_PORT)，确认输出是否为5001，如果不是，检查path.join(__dirname, "../.env")是否指向正确的文件位置。
2. Windows环境变量缓存：重启终端或电脑，避免旧环境变量残留影响。

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