Supabase CLI本地开发遇RLS策略不可见及Realtime启用失败求助

针对RLS策略在本地Studio不显示的问题 #

可能原因 #

1. 本地Studio的元数据同步机制延迟，已生效的策略未被UI抓取到
2. CLI版本与内置Studio版本存在兼容性冲突（切换Beta版也可能存在适配问题）
3. 手动通过SQL创建的策略，Studio的元数据扫描未识别到

解决方案/临时办法 #

• 强制刷新元数据：在本地Studio左侧数据库菜单旁点击刷新图标，或进入对应表的页面后点击右上角的刷新按钮，多次尝试确保元数据同步。
• 用SQL工具管理策略：通过终端执行supabase db psql连接本地数据库，用SELECT * FROM pg_policies WHERE tablename = '你的表名';确认策略存在，后续直接用SQL命令（如CREATE POLICY/ALTER POLICY）管理策略，绕过Studio UI。
• 降级/重装CLI：卸载当前版本后重装前一个稳定版试试：

  brew uninstall supabase
  brew install supabase@1.112.0
  brew link supabase@1.112.0 --force
  

  完成后执行supabase start --reset重启环境。

针对无法通过Studio启用Realtime的问题 #

可能原因 #

1. 本地Realtime服务未正常启动或运行异常
2. Studio UI与Realtime服务的通信出现故障
3. 表的Replica Identity未配置正确，导致无法启用Realtime

解决方案/临时办法 #

• 检查Realtime服务状态：终端执行supabase status，确认realtime服务状态为running。如果未运行，执行supabase stop && supabase start重启所有服务。
• 用SQL手动启用Realtime：直接通过SQL命令完成配置，无需依赖Studio：

  -- 先配置表的Replica Identity为FULL（必填）
  ALTER TABLE 你的表名 REPLICA IDENTITY FULL;
  -- 给角色授予Realtime访问权限（按需调整角色）
  GRANT USAGE ON SCHEMA public TO anon, authenticated;
  

• 检查Realtime配置文件：查看本地项目的supabase/realtime/config.toml，确保目标表未被排除在Realtime监听范围外（如果有自定义配置的话）。

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