网关类问题的高效排法不是猜，而是沿归属链核：这笔请求最终记在哪个 user、哪把 key、哪个 group、哪个 upstream account、哪个 model、多少 token、扣了多少。dev.to 自托管指南把这套核法列为上线验收动作；Sub2API 的 Precise Billing + Admin Dashboard 正好提供这条链的数据。

适用场景：成员说“扣费不对/调了没反应/打到错模型”，或月底账单与成员自报对不上时。

排障 对账 Admin Dashboard 归属链

操作步骤

  1. 让报障人给出时间、用的 Key 备注名、请求的 model 名——没有这三样先不查。
  2. 在 Admin Dashboard 的用量/记录里按时间定位请求，逐项核 user / key / group / account / model / token count / charge。
  3. 若 model 对不上：查分组的模型别名映射；若是 Composite 组，再查 route 解析（条目 5 的解析顺序）与具体平台的 channel 映射/定价。
  4. 若压根没记录：查 Key 是否有效、用户是否还有余额/额度、上游是否不可用（该指南建议这三类负面情形都要预先测过）。
  5. 若多轮会话异常：先查反代 header（条目 3 的 Nginx 下划线 header 问题），再怀疑模型。

配置说明

⚠️ 本条给的是排障顺序（经验），不是官方菜单路径；Dashboard 里记录页面的确切名称/筛选字段未在 README 核验，需在 LIN 版本后台确认后补截图。

注意事项

  • ⚠️ 成员报障只说“不能用了”就开始改配置——先定位归属链再动手。
  • ⚠️ 改完分组/路由不做回归，又引入新的别名映射错误。

来源：https://dev.to/skedaddle/how-to-self-host-an-ai-api-gateway-with-sub2api-3i99