RestAssured序列化移除布尔字段is前缀问题排查与解决

问题根源 #

出现这个问题的核心是Jackson（RestAssured默认依赖的序列化库）对布尔类型字段的默认命名规则，和你手动指定的@JsonProperty注解产生了冲突，具体细节：

• Jackson的JavaBean解析器会自动处理布尔字段：如果字段以is开头（比如isActive），它默认会把序列化后的键名处理为去掉is前缀、首字母大写的形式（也就是Active）。
• 如果你定义的getter方法不符合JavaBean规范（比如写成getIsActive()而不是isActive()），Jackson会优先根据getter方法推断字段名，直接忽略你加的@JsonProperty注解。
• 另外，RestAssured默认的ObjectMapper可能启用了某些全局命名策略，也会覆盖@JsonProperty的局部配置。

解决方法 #

1. 修正getter方法命名（最常用的解决方式） #

布尔类型字段的getter要严格遵循JavaBean规范：对于isXxx格式的字段，getter方法应该是isXxx()，而不是getIsXxx()。示例代码：

public class Feature {
    @JsonProperty("isActive")
    private boolean isActive;
    
    @JsonProperty("isAutomatedFeature")
    private boolean isAutomatedFeature;

    // 正确的getter方法
    public boolean isActive() {
        return isActive;
    }

    public void setActive(boolean active) {
        isActive = active;
    }

    public boolean isAutomatedFeature() {
        return isAutomatedFeature;
    }

    public void setAutomatedFeature(boolean automatedFeature) {
        isAutomatedFeature = automatedFeature;
    }
}

修正后，Jackson会正确识别@JsonProperty指定的键名，不会自动移除is前缀。

2. 给RestAssured配置自定义ObjectMapper #

如果修正getter后问题依然存在，可以直接替换RestAssured默认的ObjectMapper，强制禁用默认命名策略，确保注解优先级：

// 创建自定义ObjectMapper
ObjectMapper customMapper = new ObjectMapper();
// 禁用默认命名策略，严格按照注解指定的键名序列化
customMapper.setPropertyNamingStrategy(PropertyNamingStrategy.NONE);
// 关闭"用getter当作setter"的自动推断
customMapper.configure(MapperFeature.USE_GETTERS_AS_SETTERS, false);

// 配置RestAssured使用这个自定义Mapper
RestAssured.config = RestAssured.config()
    .objectMapperConfig(new ObjectMapperConfig()
        .jackson2ObjectMapperFactory((type, s) -> customMapper));

3. 改用@JsonGetter注解（补充方案） #

如果不想修改现有getter方法，可以直接在getter上标注@JsonGetter来指定序列化键名，它的优先级比默认命名规则更高：

public class Feature {
    private boolean isActive;
    private boolean isAutomatedFeature;

    @JsonGetter("isActive")
    public boolean isActive() {
        return isActive;
    }

    @JsonGetter("isAutomatedFeature")
    public boolean isAutomatedFeature() {
        return isAutomatedFeature;
    }

    // setter方法保持原有逻辑即可
}

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