为什么页面setup一直是loading状态

[caixukungg]

为什么页面setup一直是loading状态

[WillemJiang]

直接原因

setup 页面（frontend/src/app/(auth)/setup/page.tsx）初始处于 mode = "loading"，会一直显示 "Loading…"，直到浏览器发出的 GET /api/v1/auth/setup-status 请求返回。而这个客户端请求（frontend/src/core/auth/setup.ts::fetchSetupStatus）没有设置任何超时——只要后端不返回、也不报错，页面就会永远卡在 loading。

关键的不对称（这就是为什么会"卡住"而不是跳走）

同一条 setup-status 接口被调用了两次，超时策略不同：

• 服务端渲染（(auth)/layout.tsx → core/auth/server.ts::getServerSideUser）：带 5 秒超时。如果后端 5 秒内没响应，就 fallback 成 unauthenticated，于是 setup 页面被渲染出来。
• 客户端（setup 页面的 fetchSetupStatus）：无超时。

也就是说：只要 Gateway 在监听端口（能 accept 连接）但接口内部卡住，5 秒后页面会渲染出来，然后客户端请求一直 pending → 永远 loading。这也是为什么你看到的是页面的 "Loading…"，而不是 "Service temporarily unavailable"（后者意味着 Gateway 完全连不上）。

接口为什么会卡住

/api/v1/auth/setup-status（backend/app/gateway/routers/auth.py:464）最终要执行 get_local_provider().count_admin_users()——一个查数据库的调用。它卡住几乎都是因为数据库 / 认证 Provider 还没就绪，最常见于：

1. 首次启动，Gateway 在跑 alembic 迁移（alembic upgrade head 在启动时执行），迁移没完成前 users 表/连接还没准备好；
2. 数据库连不上或配置不对（config.yaml 里 database 段、或 Postgres 没启动）；
3. Docker / make dev 下某个服务没真正起来。

如何定位（按顺序）

1. 浏览器 F12 → Network，找到 setup-status 这个请求：

• 一直 Pending → 后端接口 hang 住（最可能，见上）；
• 502 / 504 → Gateway 没起来或 nginx 转发失败；
• CORS error → 跨域/入口端口不对。

2. 直接 curl 后端，绕过浏览器和 nginx：
   curl -v http://localhost:8001/api/v1/auth/setup-status
3. 如果这条也卡住，就确认是 Gateway 这个接口 hang 了。
4. 经过 nginx 再试：curl -v http://localhost:2026/api/v1/auth/setup-status
5. Gateway 健康检查：curl http://localhost:8001/health
6. 看 Gateway 日志，重点找数据库连接错误、迁移失败、auth provider 初始化报错。
7. make doctor 检查配置与依赖。

常见修复

• 确保数据库（Postgres，或你配置的 backend）已启动且可连接；检查 config.yaml 的 database 配置。
• 首次启动请等迁移跑完；若迁移失败，按日志修复后重启 Gateway。
• 确认所有服务都起来了（Gateway 8001、nginx 2026），并通过正确入口 http://localhost:2026 访问，而不是直接访问前端 3000 端口。

[caixukungg]

谢谢大佬