OpenAPI Generator处理含default响应的Collibra Core API时Python端失败

1. Swagger/OpenAPI里GET请求能不能只定义default响应？ #

语法上允许，但不推荐。default响应是用来兜底捕获所有未明确声明的HTTP状态码，而GET请求的成功响应基本都是200，按照OpenAPI规范的最佳实践，应该显式写出200状态码和对应的响应模型。只写default不仅会让API文档可读性变差，还容易触发代码生成工具的兼容性问题——就是你碰到的这种情况。

2. 问题到底是规范问题还是生成器Bug？ #

两者都有影响，但核心是Collibra API规范不符合最佳实践：

• Collibra的部分端点（比如getInfo）只定义了default响应，这相当于没明确告诉生成器“成功请求返回什么”，属于规范编写的疏漏。
• OpenAPI Generator 7.7.0在处理这种边缘场景时，没有做兼容处理——按理说如果只有default响应，生成器应该默认把它当成成功场景的响应类型，但它直接生成了空的_response_types_map，这属于生成器的处理缺陷。

3. 不用改生成代码的修复方案 #

方案一：修改OpenAPI规范文件（最推荐） #

直接修改Collibra提供的OpenAPI YAML/JSON文件，给只有default的端点补上200状态码的响应定义，和default用同一个模型就行。比如：

paths:
  /getInfo:
    get:
      responses:
        200:
          description: 获取应用信息成功
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApplicationInfo"
        default:
          description: 默认响应
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApplicationInfo"

改完再重新生成客户端，就不会有_response_types_map为空的问题了。

方案二：用自定义模板生成客户端 #

如果没法改原始规范文件，可以自定义OpenAPI Generator的Python模板：

• 从OpenAPI Generator的仓库里复制Python客户端的模板（比如api.mustache）
• 修改模板逻辑，当检测到某个端点的响应只有default时，自动在_response_types_map里加上'200': <对应模型>的映射
• 生成客户端时用--template-dir参数指定自定义模板的目录

方案三：给OpenAPI Generator提Issue #

把这个边缘场景的问题提交到OpenAPI Generator的GitHub仓库，请求官方优化逻辑——当端点只有default响应时，默认把它映射为200状态码的响应类型。

内容的提问来源于stack exchange，提问作者bamboocha