NestJS中可为空且唯一的Email字段约束冲突问题排查

一、传入email: null触发非空约束报错的原因及修复 #

核心原因 #

1. TypeScript类型与数据库配置冲突：实体类里email被定义为string类型并添加了非空断言!，这相当于告诉TypeScript该字段必须是字符串，不能为null或undefined，但同时又给@Column配置了nullable: true允许数据库存储null，两者的矛盾导致ORM映射时出现异常。
2. 数据库结构未同步更新：如果修改实体类的nullable配置后，没有生成并执行对应的数据库迁移脚本，数据库中的email字段大概率还保留着原来的NOT NULL约束，自然会拒绝null值的插入。

修复步骤 #

1. 修正实体类字段类型：调整email的类型以允许null，同时去掉非空断言：

   // user.entity.ts
   export class User
   {
       @Column({ name: 'email', nullable: true })
       @Index('users_email_idx', { unique: true })
       email: string | null;
       ...
   }
   

2. 同步数据库结构：通过TypeORM生成并执行迁移脚本，确保数据库中的email字段真正设置为允许null：

   # 生成迁移文件
   typeorm migration:generate src/migrations/update-user-email-nullable
   # 执行迁移
   typeorm migration:run
   

二、传入已存在的email触发唯一约束报错的说明 #

这个报错是正常现象，因为你配置了唯一索引，数据库会自动拦截重复的email值插入。需要注意不同数据库对null值的唯一约束处理逻辑：

• PostgreSQL、SQLite等数据库：null不参与唯一约束校验，因此可以创建多个email为null的用户，符合你的需求。
• MySQL：默认会把多个null视为重复值，若要允许多个null存在，需要给索引添加特殊配置，比如@Index({ unique: true, where: "email IS NOT NULL" })，让唯一约束仅对非null的email生效。

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