TypeORM迁移：生产环境下如何处理‘列<column_name>包含空值’错误

问题场景 #

当生产环境数据表已有数据时，新增必填属性或重命名必填属性会触发TypeORM Schema同步错误。比如将列time重命名为minutes后，同步时会抛出：

QueryFailedError: column "minutes" contains null values

现有方案要么删除数据（生产环境不可行），要么设置nullable: true（不符合必填要求），手动编写迁移脚本又工作量大，需要更优雅的自动化处理方式。

优雅的自动化解决方案 #

方案1：基于TypeORM自动迁移的分步调整 #

TypeORM的自动迁移功能可以生成基础的字段变更代码，只需调整执行顺序即可实现无null值的必填字段变更：

• 重命名字段示例（如time→minutes）：
  1. 修改实体类，将time字段改为minutes并保持nullable: false
  2. 生成迁移文件：typeorm migration:generate -n RenameTimeToMinutes
  3. 打开生成的迁移文件，修改up方法逻辑：

     public async up(queryRunner: QueryRunner): Promise<void> {
         // 1. 先添加可空的新字段
         await queryRunner.query(`ALTER TABLE "table_name" ADD "minutes" integer`);
         // 2. 从旧字段迁移数据
         await queryRunner.query(`UPDATE "table_name" SET "minutes" = "time"`);
         // 3. 将新字段设为必填
         await queryRunner.query(`ALTER TABLE "table_name" ALTER COLUMN "minutes" SET NOT NULL`);
         // 4. 删除旧字段
         await queryRunner.query(`ALTER TABLE "table_name" DROP COLUMN "time"`);
     }
     

  4. 运行迁移：typeorm migration:run
• 新增必填字段示例：
  1. 先在实体中添加字段并设置nullable: true，生成迁移并执行（添加可空字段）
  2. 编写SQL批量填充默认值（如UPDATE table_name SET new_field = 'default_value'）
  3. 修改实体字段为nullable: false，生成新的迁移并执行（设置为必填）

方案2：利用默认值过渡 #

对于新增必填字段的场景，可以通过临时设置default属性实现自动化过渡：

1. 在实体中添加字段时，同时设置nullable: false和default: 合理默认值（如default: 0或default: CURRENT_TIMESTAMP）
2. 执行Schema同步或生成迁移执行，此时数据库会自动为已有数据填充默认值，不会出现null错误
3. 若不需要数据库层面的默认值，后续可移除实体中的default属性，再生成迁移删除数据库默认值

方案3：自定义迁移模板脚本 #

可以编写一个简单的Node.js脚本，自动检测实体变更（如重命名字段、新增必填字段），并生成带有数据迁移逻辑的模板迁移文件，减少手动修改的工作量。核心逻辑包括：

• 对比实体历史版本与当前版本的字段差异
• 自动生成「添加可空字段→迁移数据→设为必填→删除旧字段」的迁移代码片段

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