第 8 章 · 边缘函数（Edge Functions）

第 8 章 · 边缘函数（Edge Functions）

章节摘要：边缘函数（Edge Functions）是基于 Deno 运行时的 Serverless 函数，部署在全球边缘节点，用于承载需要服务端执行的后端逻辑、响应 Webhook 与定时任务。本章讲解边缘函数的运行时模型、编写与部署、触发方式，以及它与数据库、存储和第三方服务的集成方式。掌握边缘函数，你就拥有了在前端直连数据库之外、处理复杂业务编排与外部交互的后端能力，是对 Supabase 数据库原生能力的有力补充。

学习目标

阅读本章后，你将能够：

• 理解边缘函数基于 Deno 的运行时模型与全球边缘部署
• 编写并部署一个边缘函数，处理 HTTP 请求
• 掌握 HTTP、数据库 Webhook、定时任务等触发方式
• 在函数中访问数据库、存储与外部 API，编排业务逻辑

本章概览

前面几章的能力大多围绕「数据」展开——数据库存数据、RLS 守数据、Realtime 推数据、Storage 存文件。但有些逻辑不适合放进数据库，例如：调用第三方支付接口、处理 GitHub 的 Webhook、定时清理过期数据、聚合多源数据再返回。这些「需要运行代码」的场景，就是边缘函数的用武之地。

它有三个关键词：Deno 运行时、全球边缘部署、Serverless。下图展示了边缘函数在 Supabase 架构中的位置，以及它如何被不同来源触发、又如何调用各类资源。

可以看到，边缘函数是「编排中枢」：它能被多种事件触发，又能调用几乎所有资源，是构建复杂后端流程的关键拼图。

子章节导航

本章按「运行时 → 编写部署 → 触发 → 集成」组织：

1. 边缘函数概念与运行时：理解 Deno、边缘部署与冷启动。
2. 函数编写与部署：动手写一个函数并发布。
3. 触发方式：HTTP、Webhook、定时任务三种入口。
4. 调用数据库与集成第三方：在函数内编排各类资源。

建议按顺序学习。第 1、2 节是基础，第 3、4 节体现边缘函数的真正价值。

与其他章节的关联

边缘函数常用服务级密钥访问数据库（绕过 RLS），因此它是对第 5 章 RLS 安全模型的「可信后端补充」。它能处理第 3 章 SQL 不便表达的复杂逻辑，能驱动第 6 章 Realtime 的数据变更，也是第 9 章 AI 集成中「调用大模型」的常见执行点。第 10 章综合实战会把它与各项能力串联。