Supabase 與 Expo 在 2026 年 11 月 10 日推出 EAS CLI 整合。使用 EAS CLI 21.8.0 以上執行 eas integrations:supabase:connect,工具可授權 Supabase、建立或連結專案、安裝 SDK,並把公開連線設定寫入 Expo 的 Production、Preview 與 Development environments。也能為 Preview 建立獨立 Supabase project,讓預覽 build 與 OTA update 不直接碰 production 資料。

這個事件值得關注,不只是少了複製環境變數的步驟,而是把行動 App 常見的環境邊界放進 CLI 流程。過去團隊很容易讓 preview build 沿用 production URL,測試帳號與測試 migration 就落在正式資料庫。新整合能降低手動配置錯誤,但不會替團隊自動設計資料遷移、Row Level Security、seed data、成本上限或既有專案切換策略。

自動化做了什麼,哪些責任仍在團隊

Expo 文件說明,connect command 會建立或連結 Supabase project、安裝 @supabase/supabase-js 與 expo-sqlite,並把 EXPO_PUBLIC_SUPABASE_URL 與 publishable key 寫入 .env.local 及 EAS 的三個環境。這兩個值本來就會放進 App,可以公開;資料是否安全依賴資料庫權限與 RLS policy。任何能繞過 RLS 的 secret key 或資料庫密碼,都不能放進 App 或 EXPO_PUBLIC_ 變數。

Supabase 公告還指出,可從 EAS CLI 執行 Security and Performance Advisors,結果會出現在 Expo build dashboard,例如未啟用 RLS 的 table 或缺少 index 的 foreign key。這能把問題拉近 build 流程,但 advisor 是檢查訊號,不是完整安全審查。權限邏輯、跨 tenant 存取、Storage policy、Edge Function secrets 與業務授權,仍需要測試與人工審查。

Preview 使用獨立 project 也不等於環境完全一致。region、extension、database schema、auth provider、redirect URL、Storage bucket、Edge Functions、cron 與第三方 webhook 都可能漂移。應把 schema migration、seed 與必要設定放進可重現流程,而不是在兩個 Dashboard 逐項點選後期待它們永遠同步。

新專案與既有專案要走不同路線

新 Expo 專案可先完成 eas init,確認 EAS project 與 Production、Preview、Development 的命名與擁有者,再執行 connect。選 region 前先決定主要使用者、法規與既有系統所在位置,因 Expo 文件明確提醒 project 建立後 region 不能更改。連線完成後,建立最小測試 table、啟用 RLS、加入 policy,並在三個環境逐一確認實際指向的 project ref。

既有 App 不應直接讓工具建立新的 production backend。使用 --link 連到既有 Supabase project 前,先匯出 EAS environment variables、記錄 project ref、Auth redirect URLs 與目前 SDK 初始化方式。connect command 會在覆寫變數前提示,但 CI 的 --overwrite 會失去這層保護;正式環境第一次切換應由人員互動執行並保存前後差異。

如果原本用 AsyncStorage、SecureStore 或自訂 auth persistence,不能因工具安裝了 expo-sqlite 就直接替換。先讀清 session storage、deep link、magic link、social login 與 token refresh 行為,再用測試帳號驗證升級。Expo 文件也提醒 mobile app 的 auto refresh 應配合 AppState,在前景啟動、背景停止;否則只驗證首次登入成功,仍可能在 App 長時間切換前後遇到 session 問題。

Preview 環境需要資料策略,不只是空資料庫

獨立 Preview project 能保護 production,但若沒有代表性資料,很多錯誤只會在正式環境出現。建立不含真實個資的 seed dataset,覆蓋不同角色、空狀態、分頁邊界、權限拒絕、時區與大量資料情境。若需要從 production 取樣,先做欄位級匿名化與最小化,並確認備份、匯出與存取政策;不能把整份正式資料複製過去後才稱為隔離。

Schema migration 應採相同版本序列,先在 Preview 套用並跑整合測試,再推到 Production。每次 build 記錄 migration version 與 Supabase project ref,才能在錯誤回報時知道 App binary、OTA update 與 backend schema 的組合。Preview OTA update 也必須指向 Preview variables;不要只測 build,卻讓 update channel 繼承錯誤環境。

Auth 與外部整合則要準備不同 credentials。Apple、Google、郵件、簡訊、付款與推播可能有 sandbox 或測試模式;webhook receiver 也應分開。若供應商只有一組 callback,至少要用明確的 environment identifier、簽章驗證與 allowlist 阻止 Preview 事件寫入 production。對發信與付費 API 設較低 quota,避免測試流程造成真實通知或成本。

CI 與 agent 自動化要限制權限

官方說明所有整合命令可 non-interactive 並回傳 JSON,方便 CI 或 agent 執行。這對建立 ephemeral environment 很有用,但也可能快速產生大量 projects、覆寫變數或把資源建在錯誤 organization。CI 應使用專用帳號與最小權限,限制可選 organization、region 與環境,並設定資源命名、到期清理與預算告警。

使用 --json 代表 non-interactive;建立 project 時還需明確 region,--overwrite 則會無提示取代環境變數。不要把這些旗標直接放進所有 branch 的預設 job。先由受保護 workflow 產生 plan,只有標記過的 preview branch 才建立資源,production link 與覆寫則要求人工核准。log 中也不要輸出 secret;publishable key 雖可公開,管理 token 與 database password 仍必須遮蔽。

清理流程要和建立流程一起完成。刪除 branch 時,確認 EAS environment、Supabase project、測試使用者、Storage 物件與第三方 webhook 是否需要保留或移除。資料保留期與備份需求要先定義,不能讓自動化直接刪除仍需調查的測試資料,也不能任由一次性 Preview project 永久累積費用。

上線驗收與回退清單

驗收至少覆蓋三個 EAS environments:列出 project ref、URL 與 publishable key 的來源,確認 Development、Preview、Production 互不指錯;以不同角色測試 RLS 的允許與拒絕;驗證 auth session、deep links、Storage、Realtime、Edge Functions、OTA updates 與 advisors;再確認 migration、seed、log 與 alert 能辨識環境。不要在公開 log 印出完整使用者資料或管理憑證。

正式切換前保留原環境變數與 SDK 設定,使用一個受控 build channel 驗證。若新整合影響 auth persistence 或 backend 指向,回退應恢復已確認的 EAS variables 與前一版 App 設定,而不是刪除剛建立的 project;資料 migration 已執行時,也要有向前修復或可驗證的 rollback 計畫。

這項整合最有價值的地方,是讓「每個環境對應哪個 backend」從人工記憶變成可重現流程。採用時應把 CLI 當作配置入口,而不是安全保證:project 隔離、RLS、migration、測試資料、外部服務與資源生命週期都能被清楚驗證,Preview 才真的成為 production 的保護層,而不只是另一個名字。