NestJS应用无法读取.env或ConfigService配置端口，始终默认3000启动

以下是导致端口始终为3000的常见原因及解决方法：

• .env文件位置错误
  确保.env文件放在项目根目录（与package.json同级），ConfigModule.forRoot()默认只会读取根目录下的.env文件，位置不对会导致配置无法加载。

• ConfigModule未正确指定env文件配置
  如果你的.env文件不在默认位置或文件名不同，需要在ConfigModule.forRoot()中显式配置路径：

  ConfigModule.forRoot({
    isGlobal: true,
    envFilePath: '.env', // 可根据实际情况修改路径，比如'.env.local'
  }),
  

• 环境变量被启动命令覆盖
  检查启动命令是否手动指定了PORT，比如PORT=3000 npm start，这种命令行传入的环境变量优先级高于.env文件中的配置，会覆盖你的设置。

• 配置未生效（缓存或模块加载问题）

  1. 清理项目缓存：删除node_modules/.cache目录或重启IDE，避免旧配置被缓存。
  2. 确保ConfigModule在AppModule的imports数组中第一个加载，避免其他模块先初始化导致配置未生效。

• PORT值类型问题
  .env中的值默认是字符串类型，虽然NestJS的listen()方法支持字符串端口，但可以尝试转为数字确保无类型问题：

  const PORT = configService.get<number>('PORT') || 3001;
  app.listen(PORT);
  

可以在bootstrap函数中添加日志验证是否正确读取到PORT值：

console.log('Loaded PORT:', PORT); // 确认输出是否为3001

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