DeepSeek Harness MISSING_CREDENTIAL 中文排查
MISSING_CREDENTIAL 表示这次请求选择的模型路由没有解析出它要求的凭据。先看当前 Provider ID 和 Profile,再检查该路由引用的凭据来源。其他提供商已经登录、另一个终端有环境变量、或者模型目录中存在模型,都不能证明本次请求拥有正确凭据。只在本地官方设置修复引用,再用新会话的小任务验证。
分享仅包含公开链接,不携带本地进度或私人配置。
确认报错的是哪条模型路由
记录当前提供商、模型、Profile 和错误码。官方 API-key 路由与账号路由独立,账号登录不会自动填入 API-key 引用。第三方提供商也可能使用自己的记录或 apiKeyEnv;不要把一个凭据复制到无关网关。
在实际运行进程的环境修复凭据
优先使用本地 Settings → Models 的对应提供商设置。直接编辑配置时,检查 apiKeyEnv 引用的名称是否准确、当前 Profile 是否使用了这一行,以及启动环境是否提供了该名称。已经运行的进程不会因为另一个终端后来 export 了变量就自动继承它。
- 只检查引用名,不公开值。
- Windows PowerShell 与 Unix shell 设置环境变量的语法不同。
- 先确认启动器实际所在机器,再检查那台机器的凭据来源。
区分缺失、无效与认证拒绝
MISSING_CREDENTIAL 是缺少所需引用值;INVALID_CREDENTIAL 指无法使用的凭据;HTTP 401 或 403 是服务器拒绝认证。新增随机字符串可能让“缺失”变为“拒绝”,不等于修复成功。对应提供商的正式账户后台决定访问权限与计费。
保存后验证一条最小请求
保存正确提供商后新建会话,明确选择该模型,请它指出一份项目文件。成功条件是请求返回且提供商与模型符合预期。继续失败时保留错误码、版本和引用名称,删除日志中可能出现的密钥、Authorization 头与私人路径。
常见问题
已经登录 DeepSeek 账号,为什么仍提示缺凭据?
先看请求使用哪条路由。官方 API key 与账号 grant 独立,彼此不自动回退。修复当前模型实际选择的认证路径。
在终端设置了环境变量,为什么 Web UI 没有读到?
核对设置变量的终端和启动 DSH 的进程是否相同。另一个终端或启动后的 export 不会自动改变既有进程环境;必要时按正确环境重新启动。
模型发现成功是否能排除凭据问题?
不能完全排除。内置目录可以不发网络请求,发现与推理也可能使用不同权限。必须单独验证实际模型请求。
修复时需要把完整密钥贴到论坛吗?
不需要。只提供已脱敏的错误、版本、路由和引用名称。在本地设置修复凭据,不向本站或公开报告发送秘密值。
官方资料
使用新版本前,打开以下固定版本或注明核验日期的资料。