阿里巴巴百炼平台连通检测以及获取模型失败

快速结论：该报错通常发生在 LobeChat 调用阿里百炼 OpenAI 兼容接口时，连通性检测和模型列表获取失败，但实际模型调用可以正常使用。优先排查百炼专属端点是否支持 /models 模型列表 API，以及升级至修复了 required 参数校验问题的 LobeChat 版本。

问题场景

用户在 LobeChat v2.2.8 版本（通过 Docker 自托管在 Linux 上）中配置阿里百炼平台自定义模型提供商时，使用带空间 ID 的专属端点：

https://{空间ID}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

在设置页面进行“连通性检测”和“获取模型列表”操作时失败，但模型实际调用（如发送对话消息）可以正常返回结果。该问题在 Chrome 浏览器中稳定复现。

报错原文

错误截图显示：连通性检测和获取模型列表失败，UI 上出现红色错误提示条，但实际模型调用正常。

注：Issue 中未提供具体文本报错，但关联的已修复 PR 存在服务端返回的 JSON 错误：

400 - {"error":{"code":"invalid_argument","message":"at '/required': got null, want array"}}

原因分析

可能有两方面原因：

协议兼容性问题（已修复）：阿里百炼平台对 API 请求的严格校验，会拒绝 required 字段为 null 的请求参数。LobeChat 在发送工具调用参数时，JSON Schema 的 required 字段若未正确初始化可能为 null，被服务端返回 400 - invalid_argument。此问题已在 2026 年 4 月的 PR #14178 中修复，将 required 字段规范化为空数组 []。
模型列表 API 不支持：百炼的专属空间端点可能不支持 /v1/models 或 /compatible-mode/v1/models 接口，导致获取模型列表时直接失败，但实际调用 /chat/completions 等接口时正常。

环境排查

LobeChat 版本：v2.2.8（建议确认是否包含 required 字段规范化修复）
部署方式：Self hosting Docker
使用端点类型：百炼专属空间端点（含空间 ID）
浏览器：Chrome
操作系统：Linux（示例环境）

解决步骤

升级 LobeChat 版本：
更新到包含 PR #14178（2026年4月25日合并）及之后修复的最新版本，确保 required 字段已经过规范化处理，避免被百炼平台校验拦截。
测试模型列表 API 可用性：
在终端使用 curl 测试百炼专属端点的模型列表接口：

curl https://{空间ID}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

如果返回 HTTP 错误或 404，说明该端点不支持模型列表 API，这是导致“获取模型列表失败”的根本原因。

对于模型列表获取失败但仍需使用百炼模型：
可以在 LobeChat 设置中手动添加模型名称和 ID，不依赖自动拉取模型列表。具体操作方式请参考 LobeChat 自定义模型提供商文档。
模型列表 API 错误处理改进（2026年6月）：
更新到包含相关错误处理修复的版本，使模型列表获取失败时能在 UI 上正确显示错误信息，替代静默返回空数组的行为。