CC-024:400:messages[].role 不接受 system
问题现象
兼容端点返回 400,错误包含 messages[1].role、unknown variant system 或只接受 user / assistant。
根因分析
客户端发送的消息结构与端点接受的协议不一致。实验性能力、客户端版本或中间层转换都可能参与,需要结合实际错误判断。
修复步骤
- 保存错误中的消息索引、模型、端点和客户端版本。
- 在新会话发送短消息,排除原有历史消息影响。
- 错误明确涉及实验性协议时,按 CC-006临时禁用 Beta 做对比。
- 仍失败时反馈实际请求编号,由服务端检查兼容处理。不要擅自改写工具历史或切到另一种云供应商路由。
预防措施
更新客户端、切换模型或端点后先做最小验证。供应商模式与实际协议保持一致,不直接照搬其他站点的模型与路由配置。