Nest.js @WebSocketGateway无法读取.env变量致WebSocket CORS异常

核心原因是Nest.js的装饰器元数据会在应用启动前被提前解析，这时候如果你的环境变量是通过ConfigModule加载的，可能还未完成.env文件的读取，导致process.env.ORIGIN在@WebSocketGateway装饰器执行时还是undefined；而onModuleInit()是模块初始化完成后才执行的，此时环境变量已经加载完毕，所以能正常读取到值。部署版本不受影响是因为生产环境通常会在应用启动前就注入环境变量，不需要依赖本地.env文件的加载流程。

以下是几种可行的解决办法：

1. 动态修改WebSocket服务器的CORS配置 #

利用onModuleInit()生命周期钩子，在模块初始化后从ConfigService获取环境变量并动态更新服务器的CORS配置：

import { ConfigService } from '@nestjs/config';
import { WebSocketGateway, WebSocketServer, OnModuleInit } from '@nestjs/websockets';

@WebSocketGateway({
  cors: {
    credentials: true,
    // 先留空，后续动态设置
    origin: ''
  },
})
export class YourGateway implements OnModuleInit {
  @WebSocketServer()
  server: any;

  constructor(private readonly configService: ConfigService) {}

  async onModuleInit() {
    // 从ConfigService获取ORIGIN并更新CORS配置
    const origin = this.configService.get<string>('ORIGIN');
    this.server.options.cors.origin = origin;
  }
}

2. 提前手动加载环境变量 #

在main.ts的最顶部手动调用dotenv的config()方法，确保环境变量在装饰器解析前就已加载完成：

import { config } from 'dotenv';
// 必须放在NestFactory.create之前执行
config();

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(3000);
}
bootstrap();

注意：如果你的项目已经通过ConfigModule.forRoot()加载环境变量，这种方式可能会和它的加载逻辑重复，但本地开发环境下可以确保装饰器能读取到变量。

3. 检查本地环境配置细节 #

• 确认本地.env文件的位置是否在项目根目录，有没有被.gitignore忽略导致未同步最新配置
• 检查是否存在.env.local等优先级更高的环境文件，覆盖了ORIGIN的值
• 验证本地环境变量是否存在拼写错误（比如ORIGIN写成ORIGIN_）

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