通过Prisma迁移修改MySQL唯一Varchar列长度遇错求助

问题详情 #

• 需求：将users表的email字段Varchar长度从80调整到128（注释标注目标为120，Schema写的是128，注意统一）
• 字段带有@unique唯一约束
• Prisma Schema配置：

email   String      @unique @db.VarChar(128) /// from 80 to 120

• 执行的迁移SQL：

-- AlterTable
ALTER TABLE `users` MODIFY `email` VARCHAR(128);

• 报错内容：

检测到目标数据库中存在失败的迁移，新迁移将不会被应用。
迁移202405133507_alter_users_email_field_length于2024-05-16 15:17:44.206 UTC启动，执行失败

原因分析 #

带Unique约束的字段修改长度时，数据库需要同时处理字段定义和唯一索引，直接修改字段长度可能因索引依赖导致迁移失败。

解决步骤 #

1. 调整迁移SQL，分三步操作
   先删除唯一索引，修改字段长度后再重新添加约束，以MySQL为例，修改后的迁移文件内容如下：

   -- 删除email字段的唯一索引（默认索引名为users_email_key，可通过数据库查询确认）
   DROP INDEX `users_email_key` ON `users`;
   
   -- 修改字段长度
   ALTER TABLE `users` MODIFY `email` VARCHAR(128);
   
   -- 重新添加唯一约束
   CREATE UNIQUE INDEX `users_email_key` ON `users`(`email`);
   

2. 确认正确的索引名称
   如果你不确定索引名，可在数据库中执行对应查询：

   • MySQL：SHOW INDEX FROM users WHERE Key_name LIKE '%email%';
   • PostgreSQL：SELECT indexname FROM pg_indexes WHERE tablename = 'users' AND indexname LIKE '%email%';

3. 重新执行迁移
   更新迁移文件后，运行prisma migrate deploy命令重新执行迁移。

注意事项 #

• 生产环境操作前一定要备份数据库，避免意外问题。
• 本次是扩大字段长度，不会触发数据截断风险，但仍需谨慎操作。

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