TypeORM插入实体指定值仍生成DEFAULT语句触发x_id非空约束报错

这个报错是TypeORM的实体属性映射规则导致的：

1. 你的Schedule实体类里只定义了关联关系属性xclass，没有显式声明和数据库外键列x_id对应的类属性。TypeORM的InsertQueryBuilder在以实体类为插入目标时，只会识别实体类上明确定义的属性作为可插入字段，你传入的普通对象里的x_id字段因为没有在实体类中声明，会被直接忽略。
2. 你的数据源配置缺少entities配置项，TypeORM初始化时没有完整加载实体元数据，进一步导致字段映射逻辑失效。

最终生成INSERT语句时，TypeORM认为你没有给x_id字段传值，自动填充了DEFAULT占位符，而数据库中x_id是外键非空列且没有配置默认值，直接触发非空约束报错，和你日志里看到的INSERT INTO "schedule"("x_id") VALUES (DEFAULT)完全对应。

任选以下一种方案即可解决问题：

• 方案1（最符合TypeORM规范，推荐）：在Schedule实体中显式定义外键列属性，和关联关系绑定
  修改后的实体代码如下：

  @Entity('schedule')
  export class Schedule extends BaseEntity {
    @PrimaryGeneratedColumn()
    schedule_id: number;
  
    // 显式声明外键列对应的实体属性
    @Column({ name: 'x_id' })
    x_id: number;
  
    @ManyToOne(() => XClass, (xclass) => xclass.schedules, {
      onDelete: 'CASCADE',
      onUpdate: 'CASCADE',
    })
    @JoinColumn({ name: 'x_id' })
    xclass: XClass;
  }
  

  改完后你原有插入逻辑、数据集都不需要调整，TypeORM就能正确识别x_id字段完成插入。
  同时记得在数据源配置中补上实体加载配置：

  const ormconfig: DataSourceOptions = {
    type: 'postgres',
    host: process.env.DB_HOST,
    port: Number(process.env.DB_PORT),
    username: process.env.DB_USER,
    password: process.env.DB_PASSWORD,
    database: process.env.DB_NAME,
    entities: ['./**/*.entity.js'], // 指向编译后的实体文件路径
    migrations: ['./**/*.seed.js'],
  };
  

• 方案2（无需修改实体，适合迁移脚本快速实现）：绕开实体映射，直接指定表名执行插入
  修改迁移中的插入逻辑，不要传入实体类作为插入目标，直接写表名字符串：

  export class Schedule1656318288443 implements MigrationInterface {
    public async up(queryRunner: QueryRunner): Promise<void> {
      await queryRunner.manager
        .createQueryBuilder()
        .insert()
        .into('schedule') // 直接传表名，不走实体属性映射逻辑
        .values(xData)
        .execute();
    }
  
    public async down(queryRunner: QueryRunner): Promise<void> {
      await queryRunner.query(`DELETE FROM "schedule"`);
    }
  }
  

  这种方式下TypeORM会直接把传入对象的字段和数据库表列做匹配，不会校验实体类上是否存在对应属性，也能正常完成插入。

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