Prisma迁移PostgreSQL报错23502：Invitation表新增字段含空值如何处理

错误本质 #

你为Invitation模型新增了两个无默认值的非空String字段aHash、sAddress，但表内已存在6条存量数据，新增字段时存量行对应列值为NULL，违反数据库非空约束，触发PostgreSQL 23502错误。

下面提供两种适用不同场景的分步操作方案：

方案1：临时允许字段为空，补全数据后再改为非空（适用暂无法确定存量数据对应字段值的场景） #

• 步骤1：修改Prisma Schema中Invitation模型的两个新增字段，加上?标记为可选

  model Invitation {
    // 原有字段保持不变
    aHash                   String? // 加?标记为可选
    sAddress                String? // 加?标记为可选
  }
  

• 步骤2：执行首次迁移，生成可选字段的迁移文件
  运行命令：npx prisma migrate dev --name add-ahash-saddress-nullable
  这一步迁移会正常执行，存量数据的两个字段默认为NULL
• 步骤3：补全所有存量数据的aHash和sAddress字段值
  你可以通过Prisma Studio、手动写SQL或者业务脚本的方式，把6条存量数据的这两个字段的值全部填好，确保没有NULL值
• 步骤4：再次修改Prisma Schema，去掉两个字段的?改回非空

  model Invitation {
    // 原有字段保持不变
    aHash                   String // 去掉?恢复非空
    sAddress                String // 去掉?恢复非空
  }
  

• 步骤5：执行第二次迁移，完成非空约束设置
  运行命令：npx prisma migrate dev --name set-ahash-saddress-not-null
  因为所有存量数据的字段都已经有值，这一步不会触发非空约束错误

方案2：直接设置默认值/手动填充存量数据，一次性完成迁移（适用已确定存量数据对应字段值的场景） #

• 步骤1：修改Prisma Schema中两个新增字段，添加默认值（如果你的业务允许统一默认值，比如空字符串）

  model Invitation {
    // 原有字段保持不变
    aHash                   String @default("")
    sAddress                String @default("")
  }
  

• 步骤2：生成迁移文件但不要执行，运行命令：npx prisma migrate dev --name add-ahash-saddress --create-only
  这一步会在prisma/migrations目录下生成对应的SQL迁移文件，但不会应用到数据库
• 步骤3：手动修改生成的迁移SQL文件（可选，适用于你不想用统一默认值，要给存量数据自定义赋值的情况）
  打开生成的.sql迁移文件，在新增字段的语句后添加更新存量数据的SQL，示例：

  -- 原有自动生成的新增字段语句
  ALTER TABLE "Invitation" ADD COLUMN "aHash" TEXT NOT NULL DEFAULT '',
  ADD COLUMN "sAddress" TEXT NOT NULL DEFAULT '';
  
  -- 新增你自己的更新逻辑，比如按id给不同行赋值
  UPDATE "Invitation" SET "aHash" = 'xxx1', "sAddress" = 'yyy1' WHERE id = '第一条数据的uuid';
  UPDATE "Invitation" SET "aHash" = 'xxx2', "sAddress" = 'yyy2' WHERE id = '第二条数据的uuid';
  -- 把6条数据的赋值都写完
  
  -- 如果后续不需要默认值，可以执行语句删掉默认值（和你的Schema对应）
  ALTER TABLE "Invitation" ALTER COLUMN "aHash" DROP DEFAULT,
  ALTER COLUMN "sAddress" DROP DEFAULT;
  

• 步骤4：应用修改后的迁移文件
  运行命令：npx prisma migrate dev
  这一步会执行你修改后的SQL，完成存量数据赋值和字段新增，不会触发空值错误
• 步骤5（可选）：如果你的业务不需要字段默认值，把Schema里两个字段的@default("")删掉即可，后续迁移不会再报错

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