Coze 插件导入 OpenAPI 3.1 失败，这个问题并不少见，尤其是你直接拿现成的接口定义过来粘贴时。很多人以为自己只是少改了一两个字段，但实际上 Coze 的插件解析会对 schema 结构比较敏感，最容易卡住的地方就是 response body 的类型。
社区里常见的报错思路很一致：不是“接口不能用”，而是“接口文档不是 Coze 期待的形状”。比如有些 3.1 写法、空的响应 schema、过于复杂的联合类型，到了导入环节就会直接被拦下。
为什么 OpenAPI 3.1 更容易出问题
因为 3.1 的表达能力更强，但插件导入器未必会把所有高级写法都当成可用输入。对用户来说，文档看着规范；对导入器来说，可能只认一部分最朴素的结构。公开 issue 里就有人卡在“response body 只支持 object 类型”这种地方，说明插件导入对返回结构的要求并不宽松。
如果你想少踩坑，先做这三件事
- 把 OpenAPI 先收敛到更简单的 3.0.x 风格。
- 让响应体尽量是标准 `object`，别一上来就写复杂嵌套或空 schema。
- 把必填字段、请求体和返回体先简化到最小可运行版本，再逐步补充。
社区里比较实用的处理方式
很多人最后不是去“修 Coze”，而是先回头整理自己的 OpenAPI 文件，把它改得更保守一点。这样做的原因很现实：Coze 插件导入的目标不是吃掉所有 OpenAPI 语法，而是把接口稳定地变成可调用插件。文档越绕，导入越容易失败。
如果你导入时卡住，建议先看报错指向的是结构、类型还是字段名，而不是先怀疑接口本身不能用。很多时候，只是 schema 过于花哨，导入器不想猜。
一句话结论
Coze 插件导入 OpenAPI 3.1 失败，多半不是接口没写对，而是文档结构太复杂、返回体类型不合要求。先把 schema 简化，成功率通常会明显高一些。
