NestJS+TypeORM生成含重复参数的SQL查询报错问题求助

问题现象 #

相同代码部署在两个独立节点（单节点活跃，同一客户端调用），其中一个节点执行await this.profileRepository.update({ id }, data);时，TypeORM生成的UPDATE语句重复设置project_id字段，触发PostgreSQL报错：

"message": "multiple assignments to same column "project_id""
"code": "42601"

生成的错误SQL示例：

UPDATE "profile" SET "id" = $2, "created_at" = $3, "updated_at" = $4, "name" = $5, "is_default" = $6, "profile_data" = $7, "result" = $8, "project_id" = $9, "status" = $10, "stage" = $11, "markups" = $12, "parent_profile_id" = $13, "project_id" = $14 WHERE "id" = $1

可能原因 #

1. 依赖版本不一致：两个节点的TypeORM、@nestjs/typeorm或PostgreSQL驱动（pg）版本存在差异，特定版本的TypeORM存在字段重复解析的bug。
2. 实体定义重复：Profile实体类中重复定义了project_id字段（比如基类继承+子类重定义、@Column装饰器重复标注、大小写不同的属性被映射到同一列）。
3. 元数据缓存异常：TypeORM启动时生成的实体元数据缓存损坏，导致解析出重复字段；不同节点的缓存状态不一致。
4. 命名策略不统一：两个节点的TypeORM配置中namingStrategy不同，导致属性到数据库列的映射规则冲突，生成重复的列赋值。

解决办法 #

1. 统一依赖版本 #

• 对比两个节点的package.json和node_modules目录，确保TypeORM、@nestjs/typeorm、pg的版本完全一致。
• 优先升级到TypeORM 0.3.x系列的稳定版本（该版本修复了多个实体解析相关的bug）。

2. 检查并修正实体定义 #

• 打开Profile实体类，确认project_id（或对应的驼峰属性projectId）仅被@Column装饰器标注一次：

  // 正确示例
  export class Profile {
    @PrimaryGeneratedColumn()
    id: number;
  
    @Column({ name: 'project_id' }) // 明确指定列名，避免自动转换冲突
    projectId: number;
  
    // 其他字段...
  }
  

• 检查是否存在继承的基类已定义project_id，子类重复定义的情况，移除重复字段。

3. 清理元数据缓存 #

• 删除TypeORM生成的缓存文件（通常位于node_modules/.cache/typeorm或项目根目录的typeorm-cache文件夹）。
• 重启报错节点，让TypeORM重新生成实体元数据。

4. 明确指定更新字段 #

• 避免直接传入完整的data对象，手动指定需要更新的字段，排除可能重复的字段：

  await this.profileRepository.update({ id }, {
    name: data.name,
    status: data.status,
    updated_at: new Date(),
    // 仅列出需要更新的字段，不要包含重复或无需更新的列
  });
  

5. 统一命名策略配置 #

• 在NestJS的TypeORM配置中，明确指定统一的命名策略，比如SnakeNamingStrategy：

  import { Module } from '@nestjs/common';
  import { TypeOrmModule } from '@nestjs/typeorm';
  import { SnakeNamingStrategy } from 'typeorm-naming-strategies';
  
  @Module({
    imports: [
      TypeOrmModule.forRoot({
        type: 'postgres',
        host: 'your-db-host',
        // 其他数据库配置...
        namingStrategy: new SnakeNamingStrategy(), // 统一命名策略
      }),
    ],
  })
  export class AppModule {}
  

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