結論先說
- Supabase + Prisma 跑遷移,必須把「運行時連接池」和「遷移直連」兩條連接串分開。Supabase 預設的事務連接池端口適合應用運行時高並發查詢,但執行 Prisma Schema 遷移時必須改走直連或會話模式地址,否則容易報
prepared statement異常或鎖死。 - 接入 Supabase MCP 務必鎖定測試分支或本地庫,嚴禁掛載生產庫寫權限。官方支持遠程端點
https://mcp.supabase.com/mcp和本地 CLI 端點http://localhost:54321/mcp(只讀查表與慢 SQL 優化另見 /guides/codex-readonly-database-mcp-postgres-mysql-sqlite-sql)。 - Seed 腳本的核心要求是「按父子依賴順序寫入 + 全量
upsert冪等」。讓 Codex 用upsert替代create,配合prisma.config.ts聲明migrations.seed,才能確保團隊任何人多次執行npx prisma db seed都不炸庫。 - 排查外鍵報錯不要盲目刪外鍵約束。遇到 Prisma
P2003或 PostgreSQL23503,應讓 Codex 同時讀取遷移 SQL、模型onDelete語義和寫入順序,從根源修齊父子關係,禁止模型為了「跑通」悄悄去掉@relation約束。 - 反覆推演複雜多表 Schema、生成大批量測試數據並跑集成測試,會頻繁消耗 Codex 上下文與推理額度。國內若缺少外幣卡或原帳號配額吃緊,可在本站按需開通 ChatGPT Plus 充值 或高配額 ChatGPT Pro 充值,團隊多項目協作可了解 ChatGPT Business 團隊定製。

圖:本站根據 Supabase MCP 文檔 與 Prisma 官方文檔 整理的示意圖
本文根據 Prisma 官方文檔《Seeding》《Prisma CLI Reference》、Supabase 官方文檔《Model Context Protocol》及 OpenAI Codex 官方文檔《Model Context Protocol》整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。
適用於誰
- 使用 Supabase PostgreSQL + Prisma 搭全棧項目,希望讓 Codex 輔助設計表結構、生成遷移和造測試數據的開發者;
- 經常在執行
prisma migrate dev時莫名卡死,或寫 Seed 腳本反覆撞上P2003/23503外鍵約束與唯一鍵衝突報錯的人; - 想接入 Supabase MCP 或 Prisma CLI 輔助查庫排錯,但擔心 AI 誤操作線上生產庫的研發團隊。
一、環境與 MCP 安全配置:分離開發庫與遷移連接
在讓 Codex 碰數據庫前,先完成兩項基礎隔離,避免誤傷線上環境。
1. 在 ~/.codex/config.toml 按環境掛載 Supabase MCP
如果是本地跑 supabase start,推薦直接掛本地 MCP 端點,零風險且速度極快(MCP 基礎配置見 /guides/codex-mcp-config):
toml
[mcp_servers.supabase_local]
url = "http://localhost:54321/mcp"
startup_timeout_sec = 20
tool_timeout_sec = 60
enabled = true
如需連接雲端測試項目,可使用官方遠程端點 https://mcp.supabase.com/mcp 並按提示完成 OAuth 授權,或者在 Prisma 6.6+ 環境下直接使用本地 CLI 命令 npx prisma mcp。無論哪種方式,本站建議都在倉庫 AGENTS.md 中寫明數據操作紅線:
markdown
# 數據庫與 Prisma 護欄(AGENTS.md)
- 嚴禁向生產庫執行 `prisma migrate reset`、`prisma db push --force-reset` 或 `DROP TABLE`。
- 修改 `prisma/schema.prisma` 後必須先輸出遷移 SQL 摘要說明破壞性變更,再生成遷移文件。
- 禁止通過刪除外鍵約束或去掉唯一索引來繞過 `P2003` / `P2002` 測試報錯。
2. 配置連接池分離與 prisma.config.ts Seed 入口
按 Prisma 官方規範,確保運行時連接池與遷移直連清晰區分,並在 prisma.config.ts 中固定種子腳本入口:
typescript
import "dotenv/config";
import { defineConfig, env } from "prisma/config";
export default defineConfig({
schema: "prisma/schema.prisma",
migrations: {
path: "prisma/migrations",
seed: "tsx prisma/seed.ts",
},
datasource: {
url: env("DATABASE_DIRECT_URL"),
},
});
二、讓 Codex 生成可重複執行的 Seed 測試數據
測試數據最怕「第一次能跑,第二次重跑就報唯一鍵重複」或者「關聯字段全填隨機 UUID 導致外鍵全掛」。本站建議用下面這段提示詞約束 Codex 生成高質素 prisma/seed.ts:
text
請閱讀 prisma/schema.prisma 與最近一次遷移文件,編寫可重複執行的 prisma/seed.ts:
1. 嚴格按外鍵拓撲順序寫入:先 Workspace / User 等父表,再 Project / Order / Invoice 等子表;
2. 每張表全部使用基於確定性唯一鍵(如 slug、email、固定測試 ID)的 upsert,確保連續運行兩次 `npx prisma db seed` 均零報錯且不產生重複記錄;
3. 至少構造 2 個隔離的工作區(含正常數據、邊界空列表、已歸檔狀態各一份),滿足集成測試與越權校驗需要;
4. 不要在 Seed 裏硬編碼真實生產密鑰或真實用戶手機號,寫完後運行 `npx prisma db seed` 驗證兩遍並彙報各表記錄數。
訂閱與帳號準備提示:當表結構超過 20 張且涉及多租戶外鍵、RLS 權限策略與關聯查詢測試時,Codex 需要跨多文件聯合推理並反覆驗證遷移腳本(配額規則見 /guides/codex-usage-limits)。重度全棧開發推薦在本站選用 ChatGPT Pro 5x iOS 可覆蓋檔 或 ChatGPT Pro 5x 信用卡不可覆蓋檔;新帳號註冊如遇到手機驗證步驟,可查看 Codex 註冊手機驗證服務。
三、常見外鍵約束(P2003 / 23503)排查決策閉環
開發中碰到外鍵報錯,不要只貼一句報錯給模型,而要讓 Codex 連帶檢查 Schema 定義、寫入順序和級聯策略。對照下表可快速定位五類高頻故障:

圖:本站根據 Prisma CLI 文檔 與 PostgreSQL 約束機制整理的示意圖
當線上或本地測試報 Foreign key constraint failed on the field 時,可直接把報錯堆棧丟給 Codex 執行診斷:
text
運行集成測試時觸發了 Prisma P2003 外鍵報錯(日誌如下)。請不要刪除外鍵約束,按以下順序定位並做最小修復:
1. 檢查報錯涉及的父子表在 prisma/schema.prisma 中的 @relation 字段映射與 onDelete 策略;
2. 核對寫入或刪除鏈路中是否存在「子表先於父表創建」或「並發事務未在同一 $transaction 內提交」;
3. 如果是 Supabase 的 auth.users 跨 schema 關聯問題,檢查是否遺漏 multiSchema 聲明或同步觸發器;
4. 給出根因說明、最小補丁以及一條能復現並鎖定該邊界的迴歸測試用例。
在複雜多包倉庫中,建議把 Prisma Schema 與數據庫測試拆到獨立子目錄並配合分層 AGENTS.md(方法見 /guides/codex-large-monorepo-layered-agents-md-scoped-test-guide),避免每次改表都全倉掃描浪費額度。
常見問題
問:Supabase 的 auth.users 表要不要直接用 Prisma 外鍵連上去?
答:可以藉助 Prisma 的 multiSchema 特性聲明,但在實際團隊協作中常會給遷移歷史和本地 shadow database 帶來維護成本。本站更建議在 public schema 建一張 profiles 表存 user_id(UUID),配合數據庫觸發器在用戶註冊時自動同步,業務表統一外鍵關聯 public.profiles,遷移會乾淨很多。
問:怎麼防止 Codex 在修遷移衝突時順手執行 prisma migrate reset 把本地辛苦造的數據清光?
答:除了在 AGENTS.md 明確禁用破壞性命令外,核心防線是不要在非交互腳本里隨意放開全自動命令執行,保留對包含 reset、drop、truncate 命令的人工審批;同時把常用演示數據沉澱進冪等 prisma/seed.ts,即便需要重建測試庫也能一條命令秒級恢復。
問:日常重度用 Codex 管數據庫遷移、寫全棧接口很耗額度,怎麼開通高配額訂閱、團隊能否開增值稅發票?
答:可前往本站 AI 會員充值總覽 按需選購 ChatGPT Plus 充值、ChatGPT Plus 自助卡密 或更高配額的 ChatGPT Pro 充值,多人研發團隊可諮詢 ChatGPT Business 團隊定製。支持支付寶、微信支付與 AlipayHK,自助卡密無需交出帳號密碼,並支持開具增值稅發票;實時價格以商品頁展示為準,售後執行掉訂閱按剩餘天數折退、封號不在質保範圍規則。
相關教學
- Codex 接入只讀數據庫 MCP(PostgreSQL / MySQL / SQLite)查表結構與慢 SQL 優化
- Codex 怎麼配置 MCP:codex mcp add 命令、config.toml 寫法與常見問題
- Codex 寫代碼時愛刪測試或亂改無關文件怎麼辦:5 條 AGENTS.md 硬約束護欄
- Codex 接手大型 Monorepo 項目怎麼配:子目錄分層 AGENTS.md 與局部測試技巧
參考資料
- Prisma 官方文檔:Seeding your database — https://www.prisma.io/docs/orm/prisma-migrate/workflows/seeding
- Prisma 官方文檔:Prisma CLI Reference — https://www.prisma.io/docs/orm/reference/prisma-cli-reference
- Supabase 官方文檔:Model Context Protocol (MCP) — https://supabase.com/docs/guides/getting-started/mcp
- OpenAI Codex 官方文檔:Model Context Protocol — https://learn.chatgpt.com/docs/extend/mcp
0 條評論
還沒有評論,來搶沙發~