在Supabase多环境开发中利用Webhooks动态管理Edge Functions

针对你遇到的Webhook URL跨环境迁移问题，有几个实用的解决方案，能让Webhook自动适配当前环境的Edge Function地址：

方案1：利用Supabase项目变量+SQL迁移脚本 #

Supabase支持项目级别的环境变量，不同环境（本地/预发布/生产）可以设置不同的变量值，再通过SQL迁移脚本动态引用这些值来创建Webhook：

1. 在各环境设置变量
   • 本地：通过Supabase CLI执行 supabase secrets set EDGE_FUNCTION_WEBHOOK_URL=http://localhost:54321/functions/v1/your-target-function
   • 预发布/生产：在Supabase控制台的「Settings」→「Secrets」页面添加EDGE_FUNCTION_WEBHOOK_URL，值设为对应环境的Edge Function URL
2. 编写动态创建Webhook的SQL迁移脚本
   创建一个SQL文件（比如migrations/20240520120000_setup_webhook.sql），内容如下：

   CREATE OR REPLACE FUNCTION setup_environment_webhook()
   RETURNS void AS $$
   BEGIN
     -- 先清理同名旧Webhook，避免重复创建
     DELETE FROM supabase_webhooks.webhooks
     WHERE name = 'your-webhook-identifier';
   
     -- 基于环境变量创建适配当前环境的Webhook
     INSERT INTO supabase_webhooks.webhooks (
       name,
       url,
       event_type,
       table_schema,
       table_name,
       enabled
     ) VALUES (
       'your-webhook-identifier',
       current_setting('EDGE_FUNCTION_WEBHOOK_URL'),
       'INSERT', -- 替换为你需要监听的事件类型（如UPDATE/DELETE）
       'public', -- 替换为目标表的schema
       'your-target-table', -- 替换为目标表名
       true
     );
   END;
   $$ LANGUAGE plpgsql;
   
   SELECT setup_environment_webhook();
   

3. 部署迁移脚本
   用Supabase CLI执行supabase db push（本地）或supabase db push --project-ref <你的预发布/生产项目ID>，脚本会自动读取当前环境的变量值，生成正确的Webhook URL。

方案2：本地模板+部署前环境变量替换 #

如果偏好更灵活的部署流程，可以用模板文件+脚本替换的方式：

1. 创建Webhook模板文件
   新建webhook-template.sql，用占位符代替URL：

   DELETE FROM supabase_webhooks.webhooks WHERE name = 'your-webhook-identifier';
   INSERT INTO supabase_webhooks.webhooks (
     name,
     url,
     event_type,
     table_schema,
     table_name,
     enabled
   ) VALUES (
     'your-webhook-identifier',
     '{{WEBHOOK_URL}}',
     'INSERT',
     'public',
     'your-target-table',
     true
   );
   

2. 编写部署脚本
   以bash脚本为例（deploy-webhook.sh），读取当前环境的.env变量并替换模板：

   #!/bin/bash
   # 加载当前环境的.env文件
   source .env
   # 替换模板中的占位符，生成最终迁移文件
   sed "s/{{WEBHOOK_URL}}/$WEBHOOK_URL/" webhook-template.sql > migrations/latest-webhook-setup.sql
   # 推送到对应Supabase环境
   supabase db push --project-ref $SUPABASE_PROJECT_REF
   

3. 配置各环境的.env
   本地.env：WEBHOOK_URL=http://localhost:54321/functions/v1/your-function
   预发布.env：WEBHOOK_URL=https://<预发布项目ID>.supabase.co/functions/v1/your-function
   生产.env：WEBHOOK_URL=https://<生产项目ID>.supabase.co/functions/v1/your-function
   部署时执行对应环境的脚本即可自动生成正确的Webhook。

方案3：手动维护各环境Webhook（小项目适用） #

如果项目规模较小、Webhook配置不频繁，可以跳过迁移脚本中的Webhook创建步骤：

• 本地开发时，用Supabase CLI创建测试用Webhook
• 预发布/生产环境直接在Supabase控制台手动创建对应URL的Webhook
  这种方式虽然不够自动化，但能彻底避免跨环境迁移的URL冲突问题。

内容的提问来源于stack exchange，提问作者Kevin Kreps