NestJS+TypeORM迁移AzureSQL时创建外键约束失败求助

问题重现 #

执行数据库迁移时，创建外键的ALTER TABLE语句报错：

ALTER TABLE "procedure" ADD CONSTRAINT "FK_f4621b8148f6622456a554adcc6" FOREIGN KEY ("patientId") REFERENCES "patient"("id") ON DELETE NO ACTION 
ON UPDATE NO ACTION

错误信息：

QueryFailedError: Error: Could not create constraint or index. See previous errors.

相同代码在本地MSSQL环境可正常运行，实体为Patient（一对多）和Procedure（多对一）的关联关系。

可能原因及解决办法 #

1. 大小写敏感性差异 #

Azure SQL默认启用区分大小写的标识符规则，而本地MSSQL可能未开启，导致表名/列名大小写不匹配。

• 解决：
  • 显式指定实体的表名，避免TypeORM自动生成的大小写差异：

    // Patient 实体
    @Entity('Patient')
    export class Patient { ... }
    
    // Procedure 实体
    @Entity('Procedure')
    export class Procedure { ... }
    

  • 在迁移脚本开头添加SET QUOTED_IDENTIFIER ON;，确保SQL Server正确解析带引号的标识符。

2. 现有数据违反外键约束 #

如果Azure SQL的Procedure表中已存在patientId值在Patient表中不存在的记录，创建外键会失败（本地环境可能为空表）。

• 解决：
  • 查询并清理无效数据：

    DELETE FROM Procedure WHERE patientId NOT IN (SELECT id FROM Patient);
    

  • 确保迁移执行前，Procedure表为空，或所有patientId均存在于Patient表中。

3. 数据类型不匹配 #

TypeORM可能在Azure SQL和本地MSSQL中生成了不同的列类型，导致外键关联的数据类型不一致。

• 解决：
  • 显式指定主键和外键列的数据类型，确保一致性：

    // Patient 实体
    @PrimaryGeneratedColumn('int')
    id: number;
    
    // Procedure 实体
    @Column({ type: 'int', nullable: false })
    patientId: number;
    
    @ManyToOne(() => Patient, patient => patient.procedures, { 
        nullable: false, 
        onDelete: 'NO ACTION', 
        onUpdate: 'NO ACTION'
    })
    @JoinColumn({ name: 'patientId', referencedColumnName: 'id' })
    patient: Patient;
    

4. 数据库用户权限不足 #

Azure SQL的数据库用户可能缺少创建外键所需的权限（本地通常使用高权限用户）。

• 解决：
  • 为用户授予ALTER和REFERENCES权限：

    GRANT ALTER ON OBJECT::dbo.Procedure TO [your-user];
    GRANT REFERENCES ON OBJECT::dbo.Patient TO [your-user];
    

5. 驱动版本兼容性问题 #

本地与Azure环境的TypeORM、mssql或tedious驱动版本不一致，导致生成的SQL语句不兼容。

• 解决：
  • 统一依赖版本，确保package.json中的typeorm、mssql、tedious版本在本地和生产环境一致，重新安装依赖后重试迁移。

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