本地Supabase实例无法创建表，报代理错误及404异常

问题详情 #

• 本地启动Supabase实例后，终端控制台显示所有服务状态正常
• 尝试在Supabase Studio中添加新表时，抛出404错误，返回内容为Supabase的404页面HTML代码
• 请求ID：b7f0977d-d03c-4fdc-857f-835e15a2611e
• 错误截图：

可能的排查方向和解决方法 #

• 确认Studio访问地址正确性
  检查访问的Supabase Studio地址是否与docker-compose.yml或config.toml中配置的端口一致（默认是http://localhost:3000），端口不匹配会直接导致404。

• 重启Supabase服务
  服务启动顺序异常可能引发依赖问题，执行以下命令重启所有服务：

  supabase stop
  supabase start
  

• 验证API服务状态
  访问默认API地址http://localhost:54321/rest/v1/，若返回{"message":"Not found"}而非404页面HTML，说明API服务正常；若返回404页面，执行docker ps检查supabase_rest容器是否运行，同时确认端口未被本地其他服务占用。

• 查看服务日志定位问题
  查看REST服务的实时日志：

  supabase logs -f rest
  

  或查看所有服务的日志：

  supabase logs -f
  

  日志中通常会包含404错误的具体触发原因。

• 检查本地配置文件
  核对supabase/config.toml中的端口、服务路径等配置项，确保没有冲突或错误配置。

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