如何阻止openapi-generator-maven-plugin为object类型生成putItem方法

问题分析 #

迁移到Jakarta EE后，使用openapi-generator-maven-plugin（6.6.0版本）生成的GetResponse类中出现了错误的putTypeItem方法：

public GetResponse putTypeItem(String key,  **typeItem**) {
  if (this.type == null) {
    this.type = new HashMap<>();
  }
  this.type.put(key, typeItem);
  return this;
}

该方法参数typeItem缺失类型，且旧JAXB版本中不存在此方法，直接导致编译失败。问题根源是generator将OpenAPI定义中带有properties的object类型字段误识别为可扩展的Map，进而生成了不必要的Map操作方法，同时因Jakarta适配的bug导致类型推导失败。

解决方案 #

1. 修正OpenAPI YAML定义，明确object类型结构 #

将type字段定义为具体的结构化Schema，添加additionalProperties: false明确该object仅包含指定属性：

GetResponse:
  properties:
    id:
      type: string
      example: 
      description: 
    type:
      type: object
      description: 
      properties:
        code:
          type: string
          description: ''
        description:
          type: string
          description: ''
      additionalProperties: false

这样generator会为type字段生成对应的POJO类，而非将其视为Map，自然不会生成多余的putTypeItem方法。

2. 升级openapi-generator版本 #

该问题疑似从5.3.0版本开始出现，属于Jakarta适配阶段的bug，尝试升级插件到最新稳定版本（如7.x系列），新版本大概率已修复此类兼容性问题。修改插件版本即可：

<version>7.6.0</version> <!-- 替换为最新稳定版 -->

3. 配置层面禁用Map操作方法生成 #

在maven插件的configOptions中添加useMapWrapper: false，强制generator将object类型字段生成POJO而非Map：

<configOptions>
  <useJakartaEe>true</useJakartaEe>
  <dateLibrary>java8</dateLibrary>
  <useMapWrapper>false</useMapWrapper>
</configOptions>

4. 自定义生成模板（终极方案） #

如果上述方法均无效，可自定义generator的模板文件，删除生成Map操作方法的逻辑：

• 复制spring generator的model.mustache模板文件到项目资源目录（如src/main/resources/templates）
• 找到生成put*Item方法的代码块并删除
• 在插件配置中指定自定义模板路径：

<configuration>
  <!-- 其他配置 -->
  <templateDirectory>${basedir}/src/main/resources/templates</templateDirectory>
</configuration>

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