SupabaseJS订阅表变更成功但未检测到变更，需配置Supabase端吗？

一、Supabase端必做配置 #

• 开启Replication（数据复制）

  1. 打开Supabase控制台，进入你的项目
  2. 左侧菜单点「Database」→「Replication」
  3. 查看「Publication」列表，确保supabase_realtime处于启用状态
  4. 点击supabase_realtime，勾选你要监听的SomeTable，保存更改
  5. 确认该表所在的schema（通常是public）已被包含在复制范围内

• 检查Row Level Security（RLS）规则
  如果你的表开启了RLS，必须给当前用户配置读取权限，否则Realtime无法获取变更。在SQL编辑器中执行以下语句：

  -- 替换SomeTable为你的表名，可按需调整权限范围
  CREATE POLICY "允许认证用户读取表数据" ON "public"."SomeTable"
    FOR SELECT USING (auth.role() = 'authenticated');
  

  若需要允许匿名用户访问，将authenticated替换为anon即可。

二、代码端排查点 #

• 过滤条件格式要正确
  确认i的类型，如果是字符串类型的ID，需要用单引号包裹：

  filter: `id=eq.'${i}'`
  

• 添加订阅状态监听
  虽然channel('any')合法，但建议用更明确的名称避免冲突，同时添加状态监听确认连接状态：

  sb.channel('some-table-change-monitor')
    .on('postgres_changes', { event: '*', schema: 'public', table:'SomeTable', filter:`id=eq.${i}`}, payload => {
      console.log('收到行变更:' + i, payload)
    })
    .subscribe((status) => {
      console.log('订阅状态:', status); // 确认是否显示SUBSCRIBED
    })
  

• 缩小匹配范围
  尽量明确指定schema（比如public，不要用*），避免范围过大导致的问题。也可以先测试单个事件类型（比如INSERT），确认能收到通知后再扩展到*。

三、其他注意事项 #

• 确保SupabaseJS库是最新版本，旧版本可能存在Realtime订阅的bug
• 检查浏览器控制台是否有报错信息，比如权限不足、连接中断等

内容的提问来源于stack exchange，提问作者A Moore