openapi-generator生成空TypeScript接口问题求助

核心原因 #

这是组件命名冲突+OpenAPI Generator 7.1.0版本的typescript-fetch生成器解析逻辑导致的问题：

• 你的OpenAPI规范里，Schema1大概率定义了一个名为Address的Schema组件（通常是对象类型）。
• 当Schema1存在时，生成器会优先将Address这个名称绑定到该组件，而Schema2中address字段的string类型定义被错误覆盖，生成了对应Address组件的空接口（可能是因为Schema1的Address组件定义不完整，或者生成器在解析3.1.0规范时的同名匹配逻辑bug）。
• 移除Schema1后，没有同名组件冲突，生成器就能正确识别address的string基础类型。

排查与解决步骤 #

1. 检查OpenAPI规范的组件定义
   打开你的OpenAPI YAML/JSON文件，查看components/schemas部分，确认是否存在名为Address的Schema（来自Schema1），且该Schema的定义可能和Schema2的address字段类型需求冲突。

2. 重命名冲突组件
   将Schema1中的Address组件重命名为唯一名称（比如UserProfileAddress），彻底避免名称冲突。示例：

   components:
     schemas:
       UserProfileAddress:  # 原名为Address
         type: object
         properties:
           street:
             type: string
           city:
             type: string
   

3. 明确指定Schema2的address字段类型
   在Schema2的定义中显式声明类型为string，避免生成器的模糊解析：

   Schema2:
     type: object
     properties:
       address:
         type: string
         description: 具体地址字符串
   

4. 调整生成器参数（可选）
   如果是生成器版本的bug，可以尝试添加生成参数避免重名问题，比如：

   openapi-generator generate -i your-spec.yaml -g typescript-fetch -o ./generated --additional-properties modelNameSuffix=Dto
   

   给所有生成的Model添加后缀，降低冲突概率。

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