第二十六轮:会话 id 入站校验 + 按账号隔离 + 422 处理器异常对象清洗

1) conversation_id 零校验 → 中文触发 httpx header ascii 编码异常,被误判成
   "上游失败"重试 3 次后回 502。现在入站校验(仅 ASCII / ≤128 字符 / 剥空白、
   空白串视作未传),非法值直接 422 且一次都不发上游。
2) 网关不再原样透传 conversation_id,改为派生 sha256("{账号}:{conversation_id}")[:32]
   作为 x-opencode-session(同账号同对话恒定、账号间隔离、不暴露账号名与业务命名)。
3) 顺修通用隐患:pydantic v2 把校验器抛出的异常对象放进 errors()[].ctx,
   而 422 处理器直接把它塞进响应体 → 序列化 TypeError → 500「网关内部错误」。
   新增 _jsonable_errors() 清洗,并剥掉 "Value error, " 前缀。

另:实测更正此前结论 —— cached_tokens 与 x-opencode-session 无稳定关系
(同一 session 连打 6 次 [0,0,0,0,896,896];缓存落定后换全新 session 亦可命中 936)。
上游是机会性内容前缀缓存;该头只是会话标识。README/CHANGELOG 已更正。

单测 171 passed / 0 failed(新增 3);隔离实例 8899 真机验证通过;未上线待批准。
This commit is contained in:
api-gateway committed 2026-09-18 12:43:13 +08:00
1 parent 17a3282574
commit bad8b43b22
5 files changed
+279 -13

No files matched your search

+37 -1
View File
@@ -4,7 +4,7 @@ from __future__ import annotations
from typing import Any
from pydantic import BaseModel, ConfigDict, Field
from pydantic import BaseModel, ConfigDict, Field, field_validator
# 不允许被客户端 `extra` / 未知字段覆盖的"核心键"。
@@ -81,6 +81,11 @@ class ToolDef(BaseModel):
function: ToolFunction
# `conversation_id` 会被放进 **HTTP header**(`x-opencode-session`)转发给上游,所以
# 长度必须收敛:header 有上限,几十 KB 的值就算上游收得下,中间的反代/网关也可能先炸。
CONVERSATION_ID_MAX = 128
class ChatRequest(BaseModel):
# 兼容性修复:OpenAI 官方 SDK 会带不少可选参数(n / presence_penalty / response_format …),
# 之前未声明的字段被 pydantic 静默丢弃,导致"网关号称 OpenAI 全兼容但参数悄悄丢失"。
@@ -147,6 +152,37 @@ class ChatRequest(BaseModel):
"""未被显式声明、靠 extra="allow" 兜住的字段名(用于日志提示,避免悄悄透传)。"""
return sorted(k for k in (self.model_extra or {}) if k not in PROTECTED_PAYLOAD_KEYS)
@field_validator("conversation_id")
@classmethod
def _validate_conversation_id(cls, v: str | None) -> str | None:
"""会话 id 的入口校验(第二十六轮)。
它最终会作为 `x-opencode-session` **HTTP header** 发往上游,所以必须在入站拦掉
两类值——否则失败发生在组 header 的那一刻,会被误报成"上游挂了":
① **非 ASCII**(中文、全角符号等):httpx 组 header 抛 `UnicodeEncodeError`
(实测 `'ascii' codec can't encode characters`),网关把它当成上游失败
**重试 3 次**(3 次必然都失败)→ 最终回 502「路由 x 全部模型调用失败」+
记一次熔断。真实原因是客户端传错了值,却被伪装成上游故障,排查成本极高。
② **过长**:header 超限同样会失败,且一行 header 塞几百 KB 毫无意义。
空白串按"未传"处理(返回 None → 上游每次随机会话),与旧行为保持一致。
"""
if v is None:
return None
v = v.strip()
if not v:
return None
if len(v) > CONVERSATION_ID_MAX:
raise ValueError(
f"过长:最多 {CONVERSATION_ID_MAX} 个字符(收到 {len(v)} 个)")
try:
v.encode("ascii")
except UnicodeEncodeError:
raise ValueError(
"只能包含 ASCII 字符(不能有中文/全角符号/emoji);建议用 uuid4().hex")
return v
# ── 图像生成 ─────────────────────────────────────────
class ImageRequest(BaseModel):