用途:Netlify Edge Functions 是在网络边缘运行的 Deno 运行时处理函数,适合低延迟的请求/响应改写、地理定位逻辑、鉴权检查与重定向、A/B 个性化。长任务、重 Node 依赖、数据库密集、后台/定时任务或内存超 512 MB 应改用 serverless functions。
主要能力:默认导出处理函数并导出 config 对象,从 @netlify/edge-functions 导入 Config/Context 类型。支持 path、excludedPath、pattern、method、header、onError、cache 等配置;可用 netlify.toml 的 [[edge_functions]] 声明多个函数并控制顺序。Context 提供 geo、cookies、next、params、ip、requestId、account/site/server/deploy 信息及 waitUntil。返回值可为 Response(结束链)、URL(同站重写,200)或 undefined(继续链)。
使用方式:文件默认放在 YOUR_BASE_DIRECTORY/netlify/edge-functions,扩展名 .js/.ts/.jsx/.tsx,需放在发布目录之外。本地开发用 npm install netlify-cli -g 后执行 netlify dev,可加 --edge-inspect 调试、--geo=mock 模拟地理。环境变量需在 UI/CLI/API 设置且作用域含 Functions,运行时用 Netlify.env.get 读取。
限制:无路由的函数会部署但静默不运行;path: "/*" 会拦截静态资源并计费。缓存需同时开启 cache: "manual" 并在代码中设置缓存头,二者缺一不可;缓存函数会遮蔽静态文件。CPU 时间 50 ms/请求,代码 20 MB 压缩,内存 512 MB,响应头超时 40 s。启用 Split Testing 时边缘函数不运行;自定义头不适用;重写仅限同站;HIPAA 托管不支持。npm 包支持为 beta。