Swagger Codegen生成含callback的OpenAPI yaml Java代码无回调相关逻辑

核心原因 #

Swagger Codegen官方提供的Spring服务端代码生成器，默认未实现OpenAPI 3.x版本的callback规则解析生成逻辑，所以你新增的callback配置会被直接忽略，导致两次生成的代码完全一致。

可行解决方案 #

• 方案1：替换为OpenAPI Generator生成代码
  OpenAPI Generator是Swagger Codegen的社区分叉版本，已原生支持Spring场景下的callback代码生成。你只需在生成配置中开启generateCallbackInterfaces参数即可：
  以Maven插件配置为例，添加如下配置项：

  <configuration>
    <generatorName>spring</generatorName>
    <generateCallbackInterfaces>true</generateCallbackInterfaces>
    <!-- 其余原有配置保持不变 -->
  </configuration>
  

  开启后会自动生成回调请求对应的Model类、回调调用接口模板，你只需实现接口中的回调发送逻辑即可。
• 方案2：自定义Swagger Codegen模板
  如果你必须使用原生Swagger Codegen，可以自定义Mustache模板适配callback规则：找到Spring服务端对应的模板目录，在API接口模板中新增遍历operation.callbacks变量的逻辑，为每个callback生成对应的调用方法和参数声明，该方案需要你熟悉Mustache语法和Swagger Codegen的内置变量结构。
• 方案3：手动补全Schema配置
  如果你不想调整生成逻辑，可以把callback中定义的请求体Schema手动迁移到OpenAPI文件的components/schemas节点下，生成工具会自动生成对应的Model类，你只需手动编写回调的HTTP调用逻辑即可。

验证注意事项 #

无论采用哪种方案，都建议使用4.0以上版本的生成工具，旧版本的生成器甚至不会解析OpenAPI文件中的callback元数据，无法完成相关逻辑生成。

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