Supabase Edge Functions 編寫與部署完整指南Deno 運行時上的無服務器利器【免費下載鏈接】supabaseThe Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.項目地址: https://gitcode.com/GitHub_Trending/supa/supabaseSupabase Edge Functions 是基于 Deno 運行時編寫、面向 Web 的無服務器函數服務幫你把后端邏輯部署到全球邊緣節點。作為 Postgres 開發平臺的核心能力之一它讓你用 TypeScript 就能快速搭建低延遲的 API 端點、Webhook 接收器和 AI 集成服務無需管理任何服務器。本文將從零帶你完成一個 Edge Function 的創建、本地調試與全球部署。什么是 Supabase Edge Functions簡單來說Edge Functions 就是一組運行在全球邊緣節點上的 TypeScript 函數。你的代碼會被分發到離用戶最近的區域執行帶來極低的網絡延遲。它為什么好用核心在于選擇了 Deno 作為運行時的設計取舍?開源且可移植函數既能在本地運行也能跑在任何 Deno 兼容平臺上?TypeScript 優先無需編譯步驟原生支持類型檢查還支持 WASM?全球分發部署一次自動覆蓋全球邊緣位置?與 Supabase 生態無縫集成可直接調用 Auth、Postgres、Storage 等全部能力 官方文檔對請求流程的概括請求先進入邊緣網關relay完成路由與 JWT 鑒權再由邊緣運行時Edge Runtime執行你的函數最后響應經網關返回客戶端全程記錄日志與指標。工作流程一圖看懂一個 Edge Function 的完整生命周期可以概括為寫代碼 → 本地調試 → 一鍵部署 → 全球調用創建函數用 CLI 腳手架生成模板或在控制臺直接用 AI Assistant 生成本地運行通過 Docker 啟動本地 Supabase 環境支持熱重載部署上線一條命令把函數分發到全球邊緣節點調用函數在你的 App 中通過 HTTP 請求或 Supabase SDK 調用關于每個階段的細節可參考官方快速上手文檔functions 快速開始、部署指南。5 分鐘創建第一個函數本地開發環境搭建第一步初始化項目并生成函數安裝 Supabase CLI 后在項目目錄執行兩個命令即可supabase init # 初始化項目生成 supabase/ 目錄 supabase functions new hello-world # 生成函數模板這條命令會在supabase/functions/hello-world/index.ts生成一個帶鑒權處理的基礎模板接收一個 JSON 請求體返回問候消息。模板默認使用 Supabase Auth 保護端點你也可以用--auth標志調整鑒權策略。第二步啟動本地運行時supabase start # 啟動本地全套 Supabase 服務需 Docker supabase functions serve hello-world # 熱重載運行你的函數本地函數運行在http://localhost:54321/functions/v1/hello-world保存代碼即自動熱重載——這是它比傳統后端開發體驗輕快的關鍵。第三步發送測試請求在控制臺打開瀏覽器編輯器也可在本地調試用 curl 或控制臺的測試面板發一個 POST 請求帶上 Publishable Key 和{name:Functions}作為請求體你會收到{ message: Hello Functions! }在控制臺直接編寫與測試免 CLI 方案如果你更喜歡純圖形界面Supabase Dashboard 提供了完整的在線開發體驗。打開控制臺后點擊 Deploy a new function你會看到三個入口Via Editor瀏覽器內編寫部署、Via AI Assistant讓 AI 幫你寫、Via CLI本地開發 版本控制。編輯器內置了模板庫——從 Simple Hello World 到 Supabase Database Access、Storage 上傳、Express Server 等選一個模板改幾行點 Deploy function 即可上線。測試同樣不用離開瀏覽器測試面板可以設置 HTTP 方法、請求體、請求頭并選擇以 service role 等身份發起調用響應狀態碼如 200和返回 JSON 一目了然體驗類似 Postman。 如果你不確定怎么寫AI Assistant 可以直接根據自然語言生成完整函數。例如輸入創建一個處理 Stripe 支付的 Edge Function它會生成包含 Stripe SDK 調用、錯誤處理的完整代碼點擊 Deploy 即可部署。最快部署方法一條命令上線全球本地調試滿意后把函數部署到生產環境只需三步supabase login # 首次使用需登錄認證 supabase link --project-ref your-project-id # 關聯遠程項目 supabase functions deploy hello-world # 部署到全球邊緣網絡部署成功后你的函數立刻在全球可訪問https://project-id.supabase.co/functions/v1/hello-world。幾個實用細節批量部署不帶函數名執行supabase functions deploy會部署functions目錄下所有函數無 Docker 環境CLI 會自動回退到 API 方式部署或用--use-api顯式指定CI/CD 自動化配合 GitHub Actions、GitLab CI 或 Bitbucket Pipelines代碼合并到主分支即自動部署官方文檔提供了完整配置示例見部署與 CI/CD 指南逐函數配置每個函數的 JWT 校驗等選項可寫在config.toml中保證各環境行為一致在應用中調用已部署的函數用 Supabase JS 客戶端一行搞定const { data, error } await supabase.functions.invoke(hello-world, { body: { name: JavaScript }, })安全管理密鑰Secrets 最佳實踐無服務器函數調用第三方 API 時絕不能把密鑰硬編碼在代碼里。Supabase 為 Edge Functions 內置了密鑰管理默認密鑰SUPABASE_URL、SUPABASE_DB_URL、SUPABASE_PUBLISHABLE_KEYS等開箱即用自定義密鑰在控制臺創建或通過 CLI 設置supabase secrets set KEYvalue讀取方式函數內用Deno.env.get(KEY)安全訪問本地開發時密鑰放在supabase/functions/.env文件中supabase start時自動加載記得把它加進.gitignore永遠不要提交到版本庫。詳細規范見環境變量文檔。?? 注意service_role等秘密密鑰可繞過行級安全策略RLS只能用在 Edge Functions 這類服務端環境嚴禁暴露到瀏覽器。排查問題日志與調試技巧函數上線后控制臺提供完整的可觀測性面板在 Functions 詳情頁的Invocations標簽下你可以看到每次調用的狀態碼、時間戳、請求體與部署版本還有按時間分布的調用圖表——排查線上問題基本靠它。更深入的調試可以直接用 Chrome DevTools本地supabase functions serve運行時用 DevTools 附加到 Deno 進程即可設置斷點、查看作用域變量和調試前端一樣順手。更多排障思路見調試指南與錯誤處理文檔。適合什么場景以及一個避坑提醒推薦場景來自官方指南場景說明低延遲 HTTP 端點公開或需鑒權的 APIWebhook 接收Stripe 支付、GitHub 事件等AI 集成編排 OpenAI 等外部 LLM 調用郵件與消息機器人Slack、Discord、Telegram Bot圖片生成Open Graph 圖片、按需處理?? 一個重要的避坑提醒Edge Functions 可能存在冷啟動且適合短生命周期、冪等的操作。如果你有長時間運行的重任務如大批量數據處理不要塞進 Edge Function而應交給后臺任務處理。另外Postgres 在邊緣環境下應視為遠程連接池服務——使用連接池或服務端驅動參考連接 Postgres 指南。總結從本地到全球的完整路線回顧一下這條無服務器開發路線創建supabase functions new或控制臺 AI Assistant 生成函數開發supabase functions serve本地熱重載調試配置Secrets 管理第三方密鑰Deno.env.get()安全讀取部署supabase functions deploy一條命令全球上線運維控制臺查看調用日志DevTools 深度調試想繼續深入倉庫里有一個包含 40 真實場景的示例集合從 Stripe Webhook、Telegram Bot 到 WASM 模塊、單元測試覆蓋幾乎所有常見玩法官方總覽文檔apps/docs/content/guides/functions.mdx示例函數合集examples/edge-functions/supabase/functions/示例項目說明與本地運行方法examples/edge-functions/README.md掌握 Edge Functions你就擁有了 Postgres 數據庫之上完整的無服務器后端能力——把數據庫、認證、存儲和函數編排放在一起構建 Web、移動端與 AI 應用會變得前所未有地簡單。【免費下載鏈接】supabaseThe Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.項目地址: https://gitcode.com/GitHub_Trending/supa/supabase創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 Supabase Edge Functions 編寫與部署完整指南：Deno 運行時上的無服務器利器
Supabase Edge Functions 編寫與部署完整指南Deno 運行時上的無服務器利器【免費下載鏈接】supabaseThe Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.項目地址: https://gitcode.com/GitHub_Trending/supa/supabaseSupabase Edge Functions 是基于 Deno 運行時編寫、面向 Web 的無服務器函數服務幫你把后端邏輯部署到全球邊緣節點。作為 Postgres 開發平臺的核心能力之一它讓你用 TypeScript 就能快速搭建低延遲的 API 端點、Webhook 接收器和 AI 集成服務無需管理任何服務器。本文將從零帶你完成一個 Edge Function 的創建、本地調試與全球部署。什么是 Supabase Edge Functions簡單來說Edge Functions 就是一組運行在全球邊緣節點上的 TypeScript 函數。你的代碼會被分發到離用戶最近的區域執行帶來極低的網絡延遲。它為什么好用核心在于選擇了 Deno 作為運行時的設計取舍?開源且可移植函數既能在本地運行也能跑在任何 Deno 兼容平臺上?TypeScript 優先無需編譯步驟原生支持類型檢查還支持 WASM?全球分發部署一次自動覆蓋全球邊緣位置?與 Supabase 生態無縫集成可直接調用 Auth、Postgres、Storage 等全部能力 官方文檔對請求流程的概括請求先進入邊緣網關relay完成路由與 JWT 鑒權再由邊緣運行時Edge Runtime執行你的函數最后響應經網關返回客戶端全程記錄日志與指標。工作流程一圖看懂一個 Edge Function 的完整生命周期可以概括為寫代碼 → 本地調試 → 一鍵部署 → 全球調用創建函數用 CLI 腳手架生成模板或在控制臺直接用 AI Assistant 生成本地運行通過 Docker 啟動本地 Supabase 環境支持熱重載部署上線一條命令把函數分發到全球邊緣節點調用函數在你的 App 中通過 HTTP 請求或 Supabase SDK 調用關于每個階段的細節可參考官方快速上手文檔functions 快速開始、部署指南。5 分鐘創建第一個函數本地開發環境搭建第一步初始化項目并生成函數安裝 Supabase CLI 后在項目目錄執行兩個命令即可supabase init # 初始化項目生成 supabase/ 目錄 supabase functions new hello-world # 生成函數模板這條命令會在supabase/functions/hello-world/index.ts生成一個帶鑒權處理的基礎模板接收一個 JSON 請求體返回問候消息。模板默認使用 Supabase Auth 保護端點你也可以用--auth標志調整鑒權策略。第二步啟動本地運行時supabase start # 啟動本地全套 Supabase 服務需 Docker supabase functions serve hello-world # 熱重載運行你的函數本地函數運行在http://localhost:54321/functions/v1/hello-world保存代碼即自動熱重載——這是它比傳統后端開發體驗輕快的關鍵。第三步發送測試請求在控制臺打開瀏覽器編輯器也可在本地調試用 curl 或控制臺的測試面板發一個 POST 請求帶上 Publishable Key 和{name:Functions}作為請求體你會收到{ message: Hello Functions! }在控制臺直接編寫與測試免 CLI 方案如果你更喜歡純圖形界面Supabase Dashboard 提供了完整的在線開發體驗。打開控制臺后點擊 Deploy a new function你會看到三個入口Via Editor瀏覽器內編寫部署、Via AI Assistant讓 AI 幫你寫、Via CLI本地開發 版本控制。編輯器內置了模板庫——從 Simple Hello World 到 Supabase Database Access、Storage 上傳、Express Server 等選一個模板改幾行點 Deploy function 即可上線。測試同樣不用離開瀏覽器測試面板可以設置 HTTP 方法、請求體、請求頭并選擇以 service role 等身份發起調用響應狀態碼如 200和返回 JSON 一目了然體驗類似 Postman。 如果你不確定怎么寫AI Assistant 可以直接根據自然語言生成完整函數。例如輸入創建一個處理 Stripe 支付的 Edge Function它會生成包含 Stripe SDK 調用、錯誤處理的完整代碼點擊 Deploy 即可部署。最快部署方法一條命令上線全球本地調試滿意后把函數部署到生產環境只需三步supabase login # 首次使用需登錄認證 supabase link --project-ref your-project-id # 關聯遠程項目 supabase functions deploy hello-world # 部署到全球邊緣網絡部署成功后你的函數立刻在全球可訪問https://project-id.supabase.co/functions/v1/hello-world。幾個實用細節批量部署不帶函數名執行supabase functions deploy會部署functions目錄下所有函數無 Docker 環境CLI 會自動回退到 API 方式部署或用--use-api顯式指定CI/CD 自動化配合 GitHub Actions、GitLab CI 或 Bitbucket Pipelines代碼合并到主分支即自動部署官方文檔提供了完整配置示例見部署與 CI/CD 指南逐函數配置每個函數的 JWT 校驗等選項可寫在config.toml中保證各環境行為一致在應用中調用已部署的函數用 Supabase JS 客戶端一行搞定const { data, error } await supabase.functions.invoke(hello-world, { body: { name: JavaScript }, })安全管理密鑰Secrets 最佳實踐無服務器函數調用第三方 API 時絕不能把密鑰硬編碼在代碼里。Supabase 為 Edge Functions 內置了密鑰管理默認密鑰SUPABASE_URL、SUPABASE_DB_URL、SUPABASE_PUBLISHABLE_KEYS等開箱即用自定義密鑰在控制臺創建或通過 CLI 設置supabase secrets set KEYvalue讀取方式函數內用Deno.env.get(KEY)安全訪問本地開發時密鑰放在supabase/functions/.env文件中supabase start時自動加載記得把它加進.gitignore永遠不要提交到版本庫。詳細規范見環境變量文檔。?? 注意service_role等秘密密鑰可繞過行級安全策略RLS只能用在 Edge Functions 這類服務端環境嚴禁暴露到瀏覽器。排查問題日志與調試技巧函數上線后控制臺提供完整的可觀測性面板在 Functions 詳情頁的Invocations標簽下你可以看到每次調用的狀態碼、時間戳、請求體與部署版本還有按時間分布的調用圖表——排查線上問題基本靠它。更深入的調試可以直接用 Chrome DevTools本地supabase functions serve運行時用 DevTools 附加到 Deno 進程即可設置斷點、查看作用域變量和調試前端一樣順手。更多排障思路見調試指南與錯誤處理文檔。適合什么場景以及一個避坑提醒推薦場景來自官方指南場景說明低延遲 HTTP 端點公開或需鑒權的 APIWebhook 接收Stripe 支付、GitHub 事件等AI 集成編排 OpenAI 等外部 LLM 調用郵件與消息機器人Slack、Discord、Telegram Bot圖片生成Open Graph 圖片、按需處理?? 一個重要的避坑提醒Edge Functions 可能存在冷啟動且適合短生命周期、冪等的操作。如果你有長時間運行的重任務如大批量數據處理不要塞進 Edge Function而應交給后臺任務處理。另外Postgres 在邊緣環境下應視為遠程連接池服務——使用連接池或服務端驅動參考連接 Postgres 指南。總結從本地到全球的完整路線回顧一下這條無服務器開發路線創建supabase functions new或控制臺 AI Assistant 生成函數開發supabase functions serve本地熱重載調試配置Secrets 管理第三方密鑰Deno.env.get()安全讀取部署supabase functions deploy一條命令全球上線運維控制臺查看調用日志DevTools 深度調試想繼續深入倉庫里有一個包含 40 真實場景的示例集合從 Stripe Webhook、Telegram Bot 到 WASM 模塊、單元測試覆蓋幾乎所有常見玩法官方總覽文檔apps/docs/content/guides/functions.mdx示例函數合集examples/edge-functions/supabase/functions/示例項目說明與本地運行方法examples/edge-functions/README.md掌握 Edge Functions你就擁有了 Postgres 數據庫之上完整的無服務器后端能力——把數據庫、認證、存儲和函數編排放在一起構建 Web、移動端與 AI 應用會變得前所未有地簡單。【免費下載鏈接】supabaseThe Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.項目地址: https://gitcode.com/GitHub_Trending/supa/supabase創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考