Skip to content

Auth error: 503 AuthRetryableFetchError

Last edited: 8/12/2026

503 状态码伴随 AuthRetryableFetchError 通常表示 Auth（GoTrue）服务无法初始化，因为它无法加载配置。

🌐 A 503 status code accompanied by an AuthRetryableFetchError typically indicates that the Auth (GoTrue) service is failing to initialize because it cannot load its configuration.

为什么会发生这种情况？ 这个问题最常见的原因是 GOTRUE_SESSIONS_TIMEBOX 设置中的持续时间字符串无效。如果配置的值出现以下情况，就会发生这种情况：

  • 超过最大支持时长（大约几百年）。
  • 使用了错误或不支持的时间单位格式。

当服务在启动时遇到无效的配置值时，它会初始化失败，导致所有认证请求都出现获取错误。

🌐 When the service encounters an invalid configuration value during startup, it fails to initialize, resulting in fetch errors for all authentication requests.

如何解决：

  1. 在仪表板中导航到 Sessions 设置。
  2. 在 用户会话 部分找到 Timebox 时长字段。
  3. 将当前值替换为更小的有效持续时间，或回退到默认值（4320 小时）。
  4. 保存你的更改。

更新此字段会触发配置重载，这会让认证服务重启并恢复正常运行。

🌐 Updating this field triggers a configuration reload, which allows the Auth service to restart and resume normal operation.