NestJS结合.env、ormconfig.ts连接PostgreSQL的各类报错咨询

核心根因 #

所有连锁报错本质是三个环节的配置完全错位，并非单个配置项的问题：

• 模块规范混用：当前ormconfig.ts采用CommonJS语法（require/module.exports），实体文件采用TS原生ES Module语法（import/export），Node运行时本身不支持直接解析TS语法，遇到实体里的import语句自然触发Cannot use import statement outside a module。
• 错位配置叠加：在package.json中添加"type": "module"后，Node会将整个项目识别为ES Module运行环境，但ormconfig.ts依然保留CommonJS的require/exports全局调用，ES Module环境不存在这些CommonJS全局对象，因此触发exports is not defined报错。
• 能力边界混淆：autoLoadEntities: true是NestJS生态对TypeORM的扩展能力，仅在Nest通过TypeOrmModule.forRoot()依赖注入加载配置时生效；如果使用独立的ormconfig给TypeORM CLI提供配置，该能力完全不会触发，因此扫描不到任何注册的实体，报EntityMetadataNotFound。
• 加载流程断层：直接在ormconfig中import实体时，ormconfig本身是被Node直接加载的独立配置文件，不经过NestJS的TS编译转译流程，TS语法的import未被转成可运行的CommonJS代码，再次触发最初的导入语法报错。

分步修复方案 #

• 第一步：删除之前在package.json中手动添加的"type": "module"配置，回到NestJS默认的CommonJS编译运行链路，避免ES Module和CommonJS的全局对象冲突。
• 第二步：纯应用运行场景（不需要TypeORM CLI跑迁移）直接移除独立的ormconfig.ts，将数据库配置挪到app.module.ts的TypeORM初始化逻辑中，确保实体导入经过NestJS的编译流程：

  // app.module.ts
  import { Module } from '@nestjs/common';
  import { TypeOrmModule } from '@nestjs/typeorm';
  import { Software } from './software/software.entity';
  
  @Module({
    imports: [
      TypeOrmModule.forRoot({
        host: process.env.DB_HOST,
        type: 'postgres',
        port: Number(process.env.DB_PORT), // 必须将环境变量传入的端口字符串转为数字类型
        username: process.env.DB_USER,
        password: process.env.DB_PASS,
        database: process.env.DB_NAME,
        synchronize: true, // 仅本地开发环境开启，生产环境需关闭
        entities: [Software], // 直接引入实体类，无需写路径通配匹配
      }),
    ],
  })
  export class AppModule {}
  

• 第三步：需要使用TypeORM CLI跑数据库迁移的场景，将ormconfig.ts改造为标准的DataSource初始化文件，搭配ts-node加载器运行，避免TS语法解析报错：
  1. 替换原ormconfig.ts的CommonJS写法为标准TS写法：

     // ormconfig.ts
     import 'dotenv/config';
     import { DataSource } from 'typeorm';
     import { Software } from './src/software/software.entity';
     
     export default new DataSource({
       host: process.env.DB_HOST,
       type: 'postgres',
       port: Number(process.env.DB_PORT),
       username: process.env.DB_USER,
       password: process.env.DB_PASS,
       database: process.env.DB_NAME,
       synchronize: false, // CLI场景必须关闭synchronize，避免迁移时误删表结构
       entities: [Software],
       migrations: ['./src/migrations/*.ts'],
     });
     

  2. 在package.json中配置CLI启动命令，指定使用ts-node加载TS格式的配置：

     {
       "scripts": {
         "typeorm": "typeorm-ts-node-commonjs -d ormconfig.ts"
       }
     }
     

注意：配置实体路径时不要使用__dirname + '/../**/*.entity.{js,ts}'的通配写法，在TS编译前后路径映射容易出现偏差，导致扫不到编译后的JS实体文件，直接手动import实体类是最稳定的方案。

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