渠道连通性测试
什么时候用、点哪个按钮、怎么看结果。
什么时候用
- 新建一条渠道保存后：先测，测通了再启用
- 渠道被「自动禁用」后：跑一次测试，如果通过会自动恢复「启用」
- 用户报「这个模型调不通」：定位是渠道问题还是别的问题
- 改了 新增渠道 里的字段（Base URL、模型列表）后
两种测试
单渠道测试
后台 → 渠道 → 某条渠道详情页 → 点「测试」按钮。
- 会做什么：用这条渠道的实际凭证 + 一个最常用的模型，发一条最小化测试请求
- 耗时：通常 < 5 秒
- 结果：
- ✅ 通过：渠道可用；若处于「自动禁用」会恢复到「启用」
- ❌ 失败：显示具体错误（401 / 404 / 500 等），按错误信息排查
批量测试
后台 → 渠道列表顶部「批量测试」按钮。
- 会做什么：对所有启用的渠道各发一次测试请求
- 耗时：取决于渠道数量；50 条大约 1~2 分钟
- 用途：定时跑（如每周一次），快速发现哪些渠道突然不可用
- 结果：在「测试日志」页可看完整结果
测试模型怎么选
测试用的模型必须是该渠道模型白名单里有的。最稳的选法：
- OpenAI：
gpt-4o-mini（便宜、几乎都通） - Anthropic：
claude-haiku-4-5 - 其他：参考 Provider 文档找一个「基础模型」
错误排查
| 错误 | 含义 | 怎么排查 |
|---|---|---|
| 401 Unauthorized | 凭证错或失效 | 去上游 Provider 控制台重新生成 API Key，回到 新增渠道 更新 |
| 404 Not Found | Base URL 错或路径不对 | 核对 Provider 文档的接入地址 |
| 400 Bad Request | 请求格式不匹配 Provider | 检查 Provider 类型是否选对（OpenAI vs Anthropic） |
| 429 Too Many Requests | 上游限流 | 调低「并发上限」或换时间再试 |
| 500 Server Error | 上游故障 | 稍后重试；持续失败则暂停该渠道 |
| 超时 | 网络问题 | 检查 Base URL 是否国内可访问；调高「超时秒数」 |