关于AWS API Gateway是否支持OpenAPI 3.1文档的技术问询

关于OpenAPI 3.1支持计划 #

AWS目前尚未公开宣布API Gateway Documentation添加OpenAPI 3.1支持的具体时间表。若需跟进相关动态，可关注AWS官方Roadmap或订阅API Gateway的服务更新通知。

无需降级的替代导入方案 #

• 自动化脚本适配转换：编写轻量脚本或使用openapi-converter这类工具，将OpenAPI 3.1定义中的特有元素（如JSON Schema 2020-12规范）转换为API Gateway兼容的3.0等价写法，仅微调少量不兼容细节，无需完全手动重构定义文件。
• 基础设施即代码（IaC）工具适配：使用AWS CDK或Terraform等IaC工具定义API Gateway时，直接引用原始OpenAPI 3.1文件，这类工具会自动处理版本兼容转换，或允许你通过代码逻辑适配API Gateway的要求，保留原始3.1定义不变。
• 文档与运行时分离配置：先基于兼容的OpenAPI 3.0版本创建API Gateway的运行时配置，再通过SwaggerHub的自动化同步工具，将OpenAPI 3.1定义同步至API Gateway Documentation中，实现运行时用3.0兼容配置、文档保留3.1完整内容的效果。

内容的提问来源于stack exchange，提问作者Math.Random