结论先说
- 先把
reset和--force-reset关进.claude/settings.json的黑名单牢笼:只写在CLAUDE.md里不够保险,必须在权限层用Bash(...)拒绝规则把清库命令彻底堵死。 - 铁律是「先加
--create-only只生成文件不落库,人工看过 SQL 再执行」:ORM 自动对比出来的 SQL 经常把「字段改名」错写成「删掉旧列再建新列」,不先看一眼 SQL 直接跑必丢数据。 - 禁止触碰历史已合入的迁移文件:任何修正都必须生成带新时间戳的增量迁移,并要求同步写出配套的反向回滚(Down)脚本。
- 复杂 Schema 演进建议配合稳健的主力推理模型:需要开通或续订订阅可查看本站 Claude Code 订阅导航页 或自动发卡的 Claude Pro iOS 自助充值商品页。

图:本站结合 Claude Code 官方权限文档 整理的四步安全迁移示意图
本文根据 Anthropic Claude Code 官方权限与设置文档(code.claude.com/docs/en/permissions)整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是软件截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 用 Prisma(Node.js) 或 SQLAlchemy + Alembic(Python) 管数据库,曾被 AI 一句「检测到迁移漂移,我帮你跑一下
reset重置」吓出冷汗的开发者; - 给存量几十万行的线上业务表加非空字段或改列名,怕生成出锁表、丢数据的危险 SQL 的后端工程师;
- 想在项目里立一套代码级硬规矩,禁止智能体篡改已经上线合入
main分支的旧迁移脚本的人。
一、第一步必配:settings.json 删库命令硬封禁清单
打开项目根目录下的 .claude/settings.json(完整安全配置体系见 Claude Code deny 拒绝规则与密钥保护),把 Prisma、Drizzle、Alembic 与裸 SQL 的毁灭性命令全部写进 deny 列表:
json
{
"permissions": {
"deny": [
"Bash(npx prisma migrate reset*)",
"Bash(pnpm prisma migrate reset*)",
"Bash(*prisma db push --force-reset*)",
"Bash(*prisma db push --accept-data-loss*)",
"Bash(alembic downgrade base*)",
"Bash(*DROP DATABASE*)"
]
}
}
配好后就算你在开启了自动编辑模式或沙箱放行的状态下(模式区别见 Claude Code 权限模式详解),一旦模型试图敲 migrate reset 走捷径解决本地漂移,客户端会毫秒级硬拦截并要求它换无损方案。如果误改了本地未提交文件,随时可用检查点回退,见 Claude Code Rewind 检查点撤回指南。
Claude Code 免上号订阅与高配额省心方案:在大仓库跑百万上下文、多子包重构或复杂慢查询排障时,固定月费订阅比纯按量 API 更容易锁死成本上限。本站支持支付宝、微信支付与 AlipayHK 卡密自助兑换 iOS 链路的 Claude Pro 自助充值、5 倍额度的 Claude Max 5x 与顶配 Claude Max 20x,无需交出账号密码。
二、三段可直接复制的安全迁移提示词模板

图:本站根据生产数据库零停机变更规范整理的四类风险拦截示意图
1. Prisma 只生成不执行 + 字段改名无损改写
text
我需要将 Order 表的 legacyStatus 字段重命名为 fulfillmentStatus 并补充索引。
请按以下安全顺序操作:
1. 修改 prisma/schema.prisma 后,仅运行 npx prisma migrate dev --create-only --name rename_order_status 生成 SQL 草稿,严禁直接应用到数据库;
2. 打开刚生成的 migration.sql 检查:如果 Prisma 默认写成了 DROP COLUMN 再 ADD COLUMN,请手动将其改写为保留存量数据的 ALTER TABLE ... RENAME COLUMN 语句,并把改好的 SQL 贴给我审阅。
2. 百万行大表零停机「分步扩缩(Expand & Contract)」方案
text
生产环境 users 表已有两百万行记录且全天高频写入,现在需要新增必填字段 tenant_id 并建联合索引。
请不要生成一条直接带 NOT NULL 锁全表的危险迁移,帮我拆成三阶段无损迁移计划与对应 SQL:
- 阶段一:仅新增可空(NULLABLE)列并使用不阻塞读写的并发建索引语法(如 PostgreSQL CONCURRENTLY);
- 阶段二:编写按主键分批(每批 2000 行)幂等回填历史存量数据的脚本;
- 阶段三:校验零空值后收紧非空约束的收尾迁移。
3. Alembic 双向迁移核验与回滚演练(Python)
text
请基于最新的 SQLAlchemy 模型运行 alembic revision --autogenerate -m "add_audit_log_table",随后逐行检查生成的脚本:
1. 核对 upgrade() 中是否误混入了与本次需求无关的索引增删;
2. 确保 downgrade() 回滚函数逻辑完整对称、非空壳 pass;
3. 在本地测试库依次跑通 upgrade head → downgrade -1 → upgrade head 闭环验证。
人工必查清单:点同意执行前,肉眼扫一遍 .sql 文件里的关键字——凡是见到 DROP、TRUNCATE、在大表事务内跑 CREATE INDEX(未加并发标记且禁用事务包裹)或未设默认值的 NOT NULL,一律先喊停核实(只读查库核对现有表数据量可配合 接入数据库 MCP 查数据指南)。
常见问题
问:智能体不小心把上周已经上线的主干旧 migration.sql 改了一行,怎么救?
答:千万不要把被改过的旧迁移文件合入主分支,否则正式服迁移校验和(Checksum)会直接报错拒绝部署。立即用 git checkout -- prisma/migrations/<旧目录> 把历史文件还原,让智能体另建一个新的迁移文件追加修改(分支冲突处理见 Claude Code 处理 Git 提交与冲突)。
问:本地开发库真的乱了需要重拉基线,但被 deny 拦住了怎么办?
答:需要重置本地空库时,由开发者本人在自己独立的系统终端标签页亲手敲命令,养成「删库重置绝不假手 AI 进程代敲」的安全习惯。
问:PostgreSQL 加 CREATE INDEX CONCURRENTLY 放在 Prisma 迁移里报错说不能跑在事务块里怎么办?
答:提醒智能体将该条并发建索引语句单独拆出,按目标数据库与迁移工具对非事务性 DDL 的官方约定单独执行,避免与普通 ALTER TABLE 混在同一个隐式事务中。
问:为什么给存量表删一个废弃字段也要分两次发版,不能改代码和删列一起上线?
答:在滚动发布(Rolling Update)或蓝绿切换期间,新旧两个版本的应用容器会短暂并存几分钟。如果你一上来就在数据库把旧列 DROP 掉了,尚未下线的旧版容器一旦执行 SELECT * 或写入该列就会立刻全线报错。正确做法是第一版先只改代码彻底停止读写该字段,等旧实例全部下线稳定一天后,第二版再提交删列迁移。
问:国内没有海外银行卡,怎么给 Claude Code 开通 Pro 或 Max 订阅最稳妥?
答:可在 Claude Code 订阅说明页 或 Claude Max 充值页 选择走苹果 iOS 官方内购链路的自助卡密,自己复制登录凭证提交即可到账,全程无需把密码交给他人;若账号偶发弹出身份核验,也可查看 Claude KYC 人工协助(失败不收费,封号不在质保范围)。
0 条评论
还没有评论,来抢沙发~