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: []。
3、若使用apiKey方式，必须指定in: header且name为Authorization，value格式为Bearer {token}，不可省略Bearer前缀。
4、禁止在security数组中传入空对象或未定义的scope列表，例如- apiKey: ["read"]会导致解析失败，应改为- apiKey: []。
四、验证请求体（requestBody）结构完整性
当接口接收JSON Payload时，OpenAPI Schema必须完整描述content.application/json.schema，且不得嵌套$ref至外部文件或URL。
1、定位到目标operation下的requestBody.content["application/json"]节点。
2、确认其schema字段存在且为object类型，禁止直接设为true或{}空对象。
3、检查schema.properties中每个字段是否都具备type声明，字符串字段应补充minLength或pattern约束，数值字段应有minimum/maximum限制。
4、移除所有$ref引用，将所引用的schema内容内联展开；例如将$ref: "#/components/schemas/UserInput"替换为实际UserInput定义的全部属性结构。
五、比对官方示例Schema的字段白名单
ChatGPT Custom Actions仅接受OpenAPI 3.0.0–3.0.3子集，部分标准字段如x-webhooks、externalDocs、discriminator等会被静默忽略或触发解析中断。
1、下载OpenAI官方提供的Custom Actions示例Schema（如petstore.yaml），作为格式基准。
2、逐项核对您的Schema是否包含以下禁止字段：x-logo、x-tagGroups、deprecated、example、examples、xml、enum、default。
3、将所有description字段内容限制在200字符以内，超出部分截断，避免因UTF-8多字节长度计算异常导致解析失败。
4、确保info.title字段仅含ASCII字母、数字、空格和短横线，不含中文、emoji或控制字符。
