Troubleshooting

gw-link 常见问题与排障

遇到 401、404、模型不存在、base_url 配置错误或请求失败时，按清单快速定位问题。

认证错误

检查 API Key 是否复制完整、是否仍然有效。

地址错误

确认 base_url 指向 gw-link 的 OpenAI 兼容入口。

模型错误

确认工具配置的模型名在 gw-link 中可用。

排障清单

  1. 先用最小请求验证 Key。
  2. 检查 base_url 是否包含正确路径。
  3. 确认模型名和权限配置。

常见问题

401 一般是什么原因？

通常是 API Key 错误、过期、权限不足或工具读取了旧环境变量。