結論先說
- 先把
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 條評論
還沒有評論,來搶沙發~