使用swagger-codegen生成Python Flask服务存根时无模型对象问题排查

我之前碰到过一模一样的问题：用swagger-codegen从OpenAPI v2规范生成Python Flask（Connexion）服务存根时，生成的源代码里完全找不到预期的模型对象。

折腾了半天后终于找到根源——我在OpenAPI定义里把一个对象命名成了File，这个名称会和工具内部的命名规则冲突！

快速解决方法 #

• 把OpenAPI规范中名为File的对象重命名为其他无冲突的名称，比如FileThing
• 重新执行swagger-codegen的生成命令

修改命名后，swagger-codegen就正常生成了预期的模型对象及对应的模块。这类问题属于工具自身的命名冲突问题，相关的类似情况在社区里已有过讨论记录。

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