Prisma 迁移前五项必检:migrate、deploy、回滚、生成 client、冒烟,少一项都能挂站。

技术栏目第一篇:把 Prisma 数据库变更当成发布的一部分,而不是「顺便跑一下」。这项清单来自几次真实上线踩坑,五步都过再发,能挡掉绝大多数「代码没问题但站点挂了」的情况。
1. 先在本地跑通
migrate dev 生成 SQL,确认没有意外 drop。重点看生成的 migration 文件本身,而不是只看命令成功:删列、改类型、加唯一索引这三类最容易造成数据丢失或写入失败。
改类型前先确认存量数据能转换;加唯一索引前先查有没有重复值;删列前先确认没有代码还在读它。这一步在本地多做五分钟,能省掉生产上的一次回滚。
2. 生产用 deploy
生产环境禁止 interactive migrate,只用 migrate deploy。它会严格按已有 migration 顺序执行,不会尝试生成新文件,也不会在遇到分歧时询问你——这正是不该在生产用 dev 的原因。
执行前先备份库;执行后立刻检查 _prisma_migrations 表里最新一条是否 success。若出现 failed,先别急着重跑,看清楚是哪条 SQL 挂了,否则容易留下半成品状态。
3. 生成 client
构建流水线里保证 prisma generate 在 next build 之前。很多人以为 deploy 会连带生成 client,实际上不会:schema 变了但 client 没重新生成,代码里访问新字段会直接报类型或运行时错误。
最稳的做法是把 generate 写进构建脚本的固定位置,而不是靠人记得手动执行。CI 里也一样,确保缓存失效后仍会重新生成。
4. 冒烟路径
至少打通:首页、一篇文章、后台登录。这三条覆盖了读列表、读详情、读授权三条最核心的查询路径,任意一条挂掉都说明迁移影响了线上主流程。
再补两条高价值路径:一次写入(发布或保存草稿)、一次后台列表筛选。写入能验证约束与默认值,筛选能验证索引与查询条件。五条都过,基本可以放心。
5. 回滚预案
记下当前 migration 名称;坏了能回到上一版镜像。回滚分两层:应用层回退镜像,数据层回退 migration。前者快、风险低,优先做;后者要写反向 SQL,务必先在副本上验证。
发布前把「当前 migration 名 + 上一版镜像 tag + 备份文件位置」三样写在发布记录里。真出事时不需要现场回忆,照着回滚即可。
我的判断:迁移出问题几乎都不是 Prisma 本身,而是把「改库」当成了顺手动作。把它当成一次正式发布来对待,这五项就是最低门槛。
延伸阅读
- 办公 Agent 想落地,先啃会议和流程两座山
- 办公助手不只是聊天,它真能替你跑活
- 办公助手能自动化的场景,别再当翻译机
- 宝贝该复查了,宠物店怎么提醒不烦人
- 本地生活门店的 Agent 团队,一次真实复盘
- 本地生活上 Agent,最先补的三个场景不是客服
- 本地生活智能体团队,4 个行业实战案例
- 本体论:让 AI 理解业务而不是背答案
- 本体论加工作流,让 Agent 真懂业务
- 别急着做 AI 早报,先核对落地三环
相关阅读
标签
双号关注
扫码关注「广说新零售」公众号 + 视频号
本地生活 AI 落地、Agent 实操、真实门店怎么跑起来。扫码关注公众号与视频号「广说新零售」,持续看可收藏的做法;有场景也可私信聊合作。

公众号

视频号
继续读
同栏目相关文章,方便对照着看。
Next 开启 cache 后三个白屏坑
Next.js 开启 cacheComponents 后,根布局乱用 cookies 会整页掉进动态渲染。
别急着做 AI 早报,先核对落地三环
AI 早报自动生成最容易做成概念稿。真正要核对的是谁在做、做错当天能不能看见、边界在哪。
AI 上线头一周,先盯紧这四件要事别放
AI 落地项目上线第一周别只看 demo。盯四件事:在不在跑、对不对、人的反应、出错怎么兜。
客户说 AI 不懂我,八成是这三种原因
AI 客服不懂客户,多半不是模型问题:不知道你是谁、没接准意图、不记得你们发生过什么。
AI 项目为什么大多死在第二个月就停
AI 落地项目第一个月有掌声,第二个月只剩没人愿意干的脏活:维护、接真业务、说服使用的人。
