Swagger Codegen生成Python客户端时allOf首个引用属性丢失问题

这是swagger-codegen v2.x版本Python生成器的已知Bug，和你的Swagger定义、用法无关，也不是自定义模板的问题（除非你修改过默认模板）。

具体原因 #

v2.x的Python生成器模板在处理allOf组合时，存在逻辑疏漏：遍历allOf引用列表时，会直接跳过第一个引用的Schema，仅合并后续引用的属性。你调整allOf首个引用后，对应属性丢失的现象完全匹配这个Bug的表现。

验证依据 #

你提到Swagger规范合法且无报错警告，说明你的allOf写法符合OpenAPI v2规范（swagger-codegen v2对应OpenAPI v2）——比如正确使用$ref引用组件、无语法错误，排除了定义或用法问题。

临时解决办法 #

1. 占位空对象绕过Bug：在allOf列表的首位添加一个空的object类型Schema，让生成器跳过这个空对象，保留后续所有引用的属性：

   InfoResponse:
     allOf:
       - type: object
       - $ref: '#/definitions/Part1'
       - $ref: '#/definitions/Part2'
   

2. 升级到swagger-codegen v3.x：v3版本已经修复了Python生成器处理allOf的逻辑缺陷。注意v3对应OpenAPI v3规范，若你的Swagger YAML是OpenAPI v2格式，v3也能兼容处理，仅需少量适配调整。

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