OpenAPI生成POJO使用Jackson反序列化出现settlementType setter冲突如何解决

问题根因 #

报错是因为OpenAPI Maven插件默认会同时生成两种setter方法：

• 标准JavaBean风格的setSettlementType(String settlementType)
• Fluent风格的settlementType(String settlementType)（方法名和字段名一致）
  Jackson反序列化时识别到两个方法都对应settlementType属性，无法判断优先级就抛出冲突错误。

可行解决方案 #

方案1：调整OpenAPI插件生成规则（优先推荐） #

直接从代码生成层面关闭Fluent setter，不需要改业务逻辑，也不影响settlementType字段的序列化输出，完全兼容外部接口要求。
在pom.xml的openapi-generator-maven-plugin配置中添加如下参数：

<plugin>
  <groupId>org.openapitools</groupId>
  <artifactId>openapi-generator-maven-plugin</artifactId>
  <!-- 你原有版本、执行配置不变 -->
  <configuration>
    <configOptions>
      <!-- 关闭Fluent setter生成 -->
      <fluentSetter>false</fluentSetter>
      <!-- 可选：关闭前缀为with的setter生成 -->
      <withSetter>false</withSetter>
    </configOptions>
  </configuration>
</plugin>

重新生成POJO后只会保留标准setSettlementType方法，冲突自动解决。

方案2：修改ObjectMapper配置（不修改生成代码时使用） #

如果无法调整插件生成规则，直接指定Jackson只识别标准JavaBean风格的setter即可，不需要修改全局可见性配置影响其他类型：

ObjectMapper mapper = new ObjectMapper();
// 仅识别带set前缀的方法为setter，忽略Fluent风格的setter
mapper.setSetterNamingStrategy(SetterNamingStrategy.JAVA_BEAN);

方案3：修正Mixin写法（如果必须用Mixin实现） #

你之前的Mixin未生效是因为只忽略了标准setter，没有处理冲突的Fluent setter，且注解存在语法错误，正确写法如下：

public abstract class SettlementTypeMixin {
    @JsonProperty("settlementType")
    String settlementType;

    // 忽略其中一个冲突的setter即可，这里选择忽略Fluent风格的setter
    @JsonIgnore
    public abstract void settlementType(String settlementType);
}

绑定Mixin时注意指定正确的目标POJO类：

mapper.addMixIn(你生成的目标POJO类.class, SettlementTypeMixin.class);

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