fix(llm): auth 规范化兜住「只填裸 key」+ 排障子命令 (1.0.15)
线上 minimax 2 把 Key 点「测试」红字:1004 Please carry the API secret key —— 根因是表单 placeholder 写 sk-...,用户照着填了**裸 key**(无 Bearer ), 而 accounts[].auth 语义是「完整 Authorization 头值」,转发时原样发就 1004。 agent.sh upstreams 一打就看出对照组:deepseek=Bearer s...d425(正常), minimax=sk-cp-...(**无 Bearer **)——光看截图红字只会猜「额度用完」。 plugin-llm - upstreams::normalize_auth:trim 后含空白→已完整;否则补「Bearer 」。 **双处应用**:upsert 写入(下次保存自愈) + read_upa 读出(让线上坏数据 立即可用,无需用户重填——存量 10 把 Key 根本不可能通知用户重填)。 - 兼容 Basic / 自定义 scheme / 前后空格 / 内部含空格共 6 个边界, 干跑 + e2e 2 条新断言全过(裸 key 200 + 靶机实收 Bearer sk-NORM-NO-SCHEME)。 前端 - placeholder 改为「Bearer sk-…(... 留空=保留原值;只填裸 key 也会自动补 Bearer)」 ——placeholder 写「前缀」会诱导漏填必要部分,写「字面值」才能正确引导。 - 多账号小节加说明文字(只填裸 key 也会自动补 Bearer)。 deploy/agent.sh - 新增 upstreams(逐账号掩码/冷却/今日负载;掩码为空显式标 **空** —— 这条 是发现「只填裸 key」类问题的关键指示器,旧镜像的回显脱敏后看不出问题) - 新增 upstream-test <slot>(调测试接口并打印厂商真实 status_code + body), 避免再靠「管理台截图 OCR」排障。 回归 281 全绿(网关 102 + LLM 179);专章 docs/llm/MULTI_ACCOUNT_ROUTING.md §10 记录现象/规则/兼容表/自检工具。
This commit is contained in:
1 parent
ab44853413
commit
f34ba3d198
8 files changed
+209
-8
No files matched your search
@@ -40,7 +40,7 @@
|
||||
| 字段 | 含义 |
|
||||
|---|---|
|
||||
| `accounts` | 多账号数组。**取代旧版单 `auth` 字段**;`accounts` 为空时由顶层 `auth` 兼容合成单账号 |
|
||||
| `accounts[].auth` | 完整的 `Authorization` 头值(如 `Bearer sk-xxx`)。留空表示免鉴权后端 |
|
||||
| `accounts[].auth` | 完整的 `Authorization` 头值(如 `Bearer sk-xxx`)。**只填裸 key 也行**——读出时 `normalize_auth` 自动补 `Bearer `,避免上游回 1004(详情见 §10) |
|
||||
| `accounts[].note` | 备注(如「华东主账号」),仅展示 |
|
||||
| `accounts[].resets` | 该账号的**额度重置周期(秒)数组**,如 `[604800, 18000]` = 周 + 5 小时。全空=不自动切换 |
|
||||
| `exhaust_status` | 命中即判「额度耗尽」的 HTTP 状态码(**上游级,所有账号共用**)。如 `[401,402,429,403]` |
|
||||
@@ -193,3 +193,60 @@ log : read_llm_acct(r) 取本次选中账号(NOCACHEABLE,与 access 同
|
||||
- **前端渲染**:以真实 `admin.css` + 真实 `upstreams.js` 渲染路径做无头浏览器断言——
|
||||
比例条宽度与负载成比例(412 vs 96 → 100% / 23%)、每账号 14 个条块、悬停峰值日期与数据逐位吻合、
|
||||
单账号老记录与无账号上游兜底正常、无横向溢出、零 JS 错误。
|
||||
|
||||
---
|
||||
|
||||
## 十、auth 规范化(兜住「只填裸 key」的历史坏数据)
|
||||
|
||||
> **适用版本**:`ipass-1.0.15+`
|
||||
|
||||
### 现象
|
||||
|
||||
线上某 slot(如 `minimax`)管理台「密钥」列能看到 `accounts[]`,但点「测试」按钮上游回:
|
||||
|
||||
```
|
||||
minimax 不通:login fail: Please carry the API secret key in the
|
||||
'Authorization' field of the request header (1004) (195 ms)
|
||||
```
|
||||
|
||||
**1004 是 MiniMax 的「缺鉴权头」错误码**,与额度耗尽无关。原因:表单 placeholder 写的是
|
||||
`sk-...`,用户照着填了**裸 key**,而 `accounts[].auth` 字段语义是「**完整的 Authorization
|
||||
头值**」——转发时网关原样发出 `Authorization: sk-cp-...`,上游只认 `Bearer sk-cp-...`,
|
||||
于是 1004。**唯一让用户感知到的现象就是「测试按钮红字」**——靶机层面的真实状态码与
|
||||
厂商错误体都看不到(管理台没回显原始 body;点「测试」之前的旧版本会回 401 而非厂商原话,
|
||||
更易让人误判成「Key 失效」)。
|
||||
|
||||
### 解决:`normalize_auth`
|
||||
|
||||
`plugin-llm/src/upstreams.rs` 新增 `normalize_auth(auth: &str) -> String`,
|
||||
**两处应用**:
|
||||
|
||||
1. **写入(`upsert`)**:用户保存时若填了裸 key(无空格),自动补 `Bearer ` 前缀存盘——
|
||||
历史坏数据在下次保存时归正,无需用户手动重填。
|
||||
2. **读出(`read_upa`)**:转发时不管盘上存的是「裸 key」、「已带 Bearer」还是「Basic 自定义」,
|
||||
读出即归一化后发往上游——**这一道是给存量坏数据用的兜底**,免去强制让用户重存的运维。
|
||||
|
||||
### 规则
|
||||
|
||||
| 输入 | 输出 | 说明 |
|
||||
|---|---|---|
|
||||
| `""`(空) | `""` | 未配 Key 是合法状态 |
|
||||
| `sk-cp-xxx`(裸 key) | `Bearer sk-cp-xxx` | 兜住"只填裸 key" |
|
||||
| `Bearer sk-cp-xxx` | `Bearer sk-cp-xxx` | 已完整,不动 |
|
||||
| `Basic dGVzdA==` | `Basic dGVzdA==` | 非 Bearer scheme 也放过 |
|
||||
| ` sk-cp-xxx ` | `Bearer sk-cp-xxx` | trim 后判定 |
|
||||
| `Bearer sk cp` | `Bearer sk cp` | 含空格 = 已完整,不动 |
|
||||
|
||||
判定逻辑一句话:**「trim 后还含空白字符 → 视为已完整;否则补 `Bearer `」**。
|
||||
|
||||
### 自检工具
|
||||
|
||||
发版后用控制面脚本自助验证(不靠用户点管理台按钮):
|
||||
|
||||
```bash
|
||||
bash deploy/agent.sh upstreams # 逐账号 Authorization 掩码 + 冷却 + 今日负载
|
||||
bash deploy/agent.sh upstream-test minimax # 真实打上游 → 打印 status_code + 厂商响应体
|
||||
```
|
||||
|
||||
`upstreams` 输出的「掩码为空 → 显式标 `**空**`」是发现这类问题的关键指示器:旧镜像没有这个
|
||||
输出(直接回脱敏后的掩码,肉眼对比看不出问题),新镜像会显式标红。
|
||||
Reference in new issue
Block a user