ChatGPT Custom Actions调用失败常见原因是API Schema未遵循OpenAPI 3.0规范，需通过Swagger Editor校验、检查路径参数一致性、security配置层级、requestBody结构完整性及比对官方字段白名单来修正。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在使用ChatGPT配置Custom Actions时发现其无法成功调用第三方接口，常见原因之一是所提供的API Schema未严格遵循OpenAPI 3.0规范。以下是验证与修正Schema格式的多种方法：
一、使用Swagger Editor在线校验
Swagger Editor是一个开源的、实时渲染并验证OpenAPI文档的工具，可快速识别语法错误、结构缺失或字段命名违规等问题。
1、访问https://www.php.cn/link/762d77fa312b52c109f63a9fa0b1edbe，确保页面加载完成。
2、将您的API Schema JSON或YAML内容全量粘贴至左侧编辑区。
3、观察右上角是否显示Valid OpenAPI specification；若出现红色报错，则需逐条查看错误定位行号及提示信息。
4、重点检查paths对象下每个operationId是否唯一、responses是否包含2xx响应定义、required字段是否在components/schemas中真实存在。
二、验证HTTP方法与路径参数声明一致性
ChatGPT Custom Actions要求所有路径参数必须在URL路径中显式声明，且对应parameter对象的in字段必须为path，同时schema类型须明确指定。
1、查找所有含路径参数的endpoint，例如/v1/users/{user_id}。
2、确认该路径下parameters数组中存在对应名称的参数项，并满足：in: path、name: user_id、required: true。
3、检查该参数的schema.type是否为string、integer或number之一，禁止使用null、anyOf、oneOf等非标类型。
4、若参数为整数型，应额外声明format: int64或format: int32，不可仅写type: integer。
三、检查securitySchemes与security应用层级
Custom Actions不支持全局security定义，所有鉴权配置必须绑定到具体operation级别，且scheme类型仅接受apiKey或http（Bearer）两种。
1、删除根级components/securitySchemes下的bearerAuth以外的scheme定义，如oauth2、mutualTLS等均不被支持。
2、确保每个需要认证的operation对象内含有security数组，且至少含一项匹配components中定义的键名，例如– bearerAuth: []。
