首页/排错/Provider 排错
Provider 排错

把凭证、endpoint 和 backend 假设拆开看以后,provider 排错会快很多

provider 报错看起来很像,但根因经常完全不同。key 可能是对的,只是 endpoint 错了;endpoint 可能是对的,但 provider 选错了;也可能整套配置没问题,只是你还以为当前走的是另一条 backend 路线。

本页是站内详情页DeepSeek TUI Provider 排错排错

这页应该先回答的问题

  • 到底是 key 错了、provider 错了,还是 endpoint 错了?
  • 当前配置里真正生效的是哪条 backend 路线?
  • 你现在排的是认证、路由,还是预期不一致问题?

这页应该帮你判断什么

这页要帮助用户把 provider 问题拆成凭证、provider 选择、endpoint 路由和运行时继承四类。

快速定位

凭证层

先确认当前 key 是否真的属于你以为正在使用的 backend。

Provider 选择层

确认配置中的 provider 是否和你的 key、模型路线一致。

Endpoint 层

在怀疑密钥前,先确认 base URL 和后端路由假设是否正确。

继承层

确认当前运行时没有被旧环境变量或旧 shell 配置悄悄覆盖。

逐步处理流程

  1. 先读当前配置
    先看当前 provider、model 和 endpoint,而不是靠记忆判断。
  2. 在正确上下文里验证凭证
    一个 backend 的有效 key,并不能证明另一条 backend 路线也没问题。
  3. 比较配置文件和环境变量
    环境变量可能在你没注意时覆盖文件里的 provider 路线。
  4. 缩小范围后再重测
    每次只改一层,才能看清到底是认证、路由,还是继承问题。

常见误区

  • provider 和 endpoint 还没确认,就先疯狂换 key。
  • 以为配置文件一定生效,但其实环境变量还在覆盖。
  • 一次把凭证、provider 和 URL 全改掉,最后反而丢失信号。

什么时候可以离开这页

当你已经知道问题属于凭证、provider 选择、endpoint 路由,还是环境变量继承时,就可以离开这页了。

直接可用的示例

先拿可执行例子,再回头做更细的调整。

换 key 前先把当前 provider 栈读清楚

先核对 provider 名称、endpoint 和环境变量覆盖,再决定要不要动凭证。

# 先看配置里的 provider 块
# 再看当前 env 覆盖
# 最后才去测凭证

一次只改 provider 的一层

更稳的 provider 排错,是把 auth、endpoint、provider 选择分层测试,而不是一次全改。

# 先测当前 key
# 再测 endpoint
# 最后再测 provider 选择

常见失败分支

先判断你卡在哪一层,再去对应分支,不要把所有问题都混成一个。

你换了 key,但一点改善都没有

那通常不是 key 本身的问题,而是 provider 或 endpoint 层本来就错了。

配置看起来对,但行为还是像继承了旧状态

先回去看环境变量和旧 shell export,不要立刻重写配置。