如何在NestJS的TypeORM现有实体中添加非空新列

按以下步骤操作，完全规避自动同步的干扰，确保已有数据填充后再设置非空约束：

1. 关闭TypeORM自动同步
   在你的ORM配置文件（如ormconfig.json）或NestJS的TypeOrmModule.forRoot()配置中，将synchronize设为false。自动同步会在启动时直接修改数据库schema，这是导致你先触发非空约束报错的核心原因。

   {
     "synchronize": false,
     // 其他配置...
   }
   

2. 生成并执行「添加可空department列」的迁移

   • 用TypeORM CLI生成迁移文件：

     typeorm migration:create -n AddNullableDepartmentToEmployee
     

   • 打开生成的迁移文件，在up方法中添加可空列：

     import { MigrationInterface, QueryRunner } from "typeorm";
     
     export class AddNullableDepartmentToEmployee1234567890123 implements MigrationInterface {
         public async up(queryRunner: QueryRunner): Promise<void> {
             await queryRunner.addColumn("employee", new TableColumn({
                 name: "department",
                 type: "varchar",
                 isNullable: true
             }));
         }
     
         public async down(queryRunner: QueryRunner): Promise<void> {
             await queryRunner.dropColumn("employee", "department");
         }
     }
     

   • 运行迁移将列添加到数据库：

     typeorm migration:run
     

3. 填充已有员工的department数据
   根据业务逻辑给现有员工设置合法的部门值，可直接执行SQL语句：

   UPDATE "employee" SET "department" = '技术部' WHERE "department" IS NULL;
   

   （替换'技术部'为实际业务中合理的部门值，或根据员工其他属性批量赋值）

4. 生成并执行「设置department列为非空」的迁移

   • 生成第二个迁移文件：

     typeorm migration:create -n MakeEmployeeDepartmentNonNullable
     

   • 在up方法中修改列的非空约束：

     import { MigrationInterface, QueryRunner } from "typeorm";
     
     export class MakeEmployeeDepartmentNonNullable1234567890456 implements MigrationInterface {
         public async up(queryRunner: QueryRunner): Promise<void> {
             await queryRunner.changeColumn("employee", "department", new TableColumn({
                 name: "department",
                 type: "varchar",
                 isNullable: false
             }));
         }
     
         public async down(queryRunner: QueryRunner): Promise<void> {
             await queryRunner.changeColumn("employee", "department", new TableColumn({
                 name: "department",
                 type: "varchar",
                 isNullable: true
             }));
         }
     }
     

   • 运行迁移生效非空约束：

     typeorm migration:run
     

5. 更新实体类定义
   在Employee实体中把department字段的nullable设为false，确保后续新插入数据时必须指定部门：

   import { Column, Entity } from "typeorm";
   
   @Entity()
   export class Employee {
       // 其他字段...
   
       @Column({ type: "varchar", nullable: false })
       department: string;
   }
   

6. 启动项目验证
   执行nest start，此时数据库schema与实体定义一致，已有数据都填充了部门值，不会再触发空值报错。

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