自建Supabase无法使用Logs Explorer，出现404及502错误求助

核心问题分析 #

Logs Explorer依赖Logflare组件提供日志采集与查询能力，同时Studio的部分API路由依赖正确的组织/项目配置，502和404错误大概率是组件未正常运行、配置缺失或路由映射错误导致。

排查步骤 #

• 检查Logflare组件状态
  Logflare是Logs Explorer的核心依赖，先确认相关容器是否正常运行：

  docker-compose ps | grep logflare
  

  若容器未处于up状态，查看启动日志定位问题：

  docker-compose logs logflare
  

  常见问题包括PostgreSQL连接失败（需确认logflare-db容器正常）、端口冲突、环境变量缺失（如LOGFLARE_API_KEY）。

• 验证Studio配置与路由映射
  两个404接口属于Studio的内部API，需检查：

  1. 查看docker-compose.yml中studio服务的环境变量，确认SUPABASE_URL指向正确的Supabase API地址（通常为http://kong:8000），LOGFLARE_API_KEY与Logflare配置一致。
  2. 检查主机8000端口是否被占用，确保Studio容器的端口映射未被干扰：

     netstat -tulpn | grep 8000
     

• 确认组织与项目初始化状态
  接口中的default-org-slug和default项目需在系统中存在：

  1. 查看Supabase根目录下的config.toml，确认default_org和default_project配置项是否正确。
  2. 连接Supabase的dashboard数据库，查询组织与项目记录：

     -- 检查组织是否存在
     SELECT * FROM dashboard.organizations WHERE slug = 'default-org-slug';
     -- 检查项目是否存在
     SELECT * FROM dashboard.projects WHERE id = 'default';
     

  若记录缺失，需重新执行初始化脚本（参考Supabase官方Self-Host初始化步骤）。

• 查看容器日志获取详细错误
  分别提取关键组件的日志，定位具体故障点：

  • Studio日志：docker-compose logs studio
  • Kong（API网关）日志：docker-compose logs kong
  • Logflare数据库日志：docker-compose logs logflare-db

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