#常见问题

#启动与连接

容器起来了但访问不了。 确认端口映射到了 8801，并且 curl http://localhost:8801/api/status 在宿主机上 返回 JSON。返回 JSON 说明服务本身正常，问题在防火墙或反向代理。

日志报数据库连接失败。 检查 SQL_DSN 的用户名、密码、库名和网络可达性。容器里的 localhost 指容器 自己，连宿主机数据库要用宿主机地址或容器网络里的服务名。

多副本部署后限流和缓存表现不一致。 多副本必须共用同一个 Redis 和同一个数据库，并且只有主节点执行表结构变更与定时 任务，其余节点用 NODE_TYPE=slave 启动。

#请求与响应

流式响应被截断。 入口层缓冲了 SSE。关闭响应缓冲并把读超时放长到分钟级。

上游报鉴权失败。 渠道里配置的是上游服务商的真实 key，客户端用的是 Geekit 令牌，两者不能混用。 检查渠道配置里的 key 和 base URL。

模型名带 -high / -thinking 后缀报模型不存在。 这些后缀由网关解析，需要在渠道的模型列表里配置对应的基础模型名。

#计费

额度扣减和预期对不上。 日志里有每次请求的计费明细，区分输入、输出、缓存命中与推理 token，再乘以渠道 倍率。先看这条日志，再核对渠道倍率配置。

预扣费之后请求失败，额度会退吗？ 会。请求失败或实际用量低于预扣时，结算阶段退回差额。

#数据

能直接改数据库里的值吗？ 不要。需要修正的持久化数据一律通过新增版本化变更处理，写在 migration/ 里。手工 改库不会传播到其他环境，也无法评审。

能从 One API 迁过来吗？ 可以，数据库完全兼容。迁移前备份，启动时会自动重放尚未应用的变更。

#还是没解决

见社区交流，附上版本、部署方式、数据库类型和日志片段。