Jackson反序列化UnrecognizedPropertyException：deleteFile未被识别求助

以下是可能导致该异常的原因及对应的解决方式：

1. 父类属性缺少Jackson注解或访问权限不足 #

父类FileTransferStructure的deleteFile属性可能未被Jackson正确识别：

• 如果属性是private且没有对应的getter/setter方法，Jackson无法通过反射访问该属性；
• 未使用@JsonProperty注解明确映射JSON字段名，导致大小写或拼写匹配失败。

解决示例：
在父类的deleteFile属性上添加注解并确保访问权限：

public class FileTransferStructure {
    // 用注解明确映射JSON字段名，同时提供getter/setter
    @JsonProperty("deleteFile")
    private boolean deleteFile;

    public boolean isDeleteFile() {
        return deleteFile;
    }

    public void setDeleteFile(boolean deleteFile) {
        this.deleteFile = deleteFile;
    }

    // 确保父类有public无参构造方法
    public FileTransferStructure() {}
}

或使用Lombok简化代码：

@Data
@NoArgsConstructor
public class FileTransferStructure {
    @JsonProperty("deleteFile")
    private boolean deleteFile;
}

2. ObjectMapper未配置支持父类属性反序列化 #

默认Jackson可能不会自动扫描父类的属性，需要显式配置字段访问规则：

解决示例：
修改parseJson方法中的ObjectMapper配置，允许直接访问字段（无需getter/setter）：

protected <C> C parseJson(String content, Class<C> clazz) throws MB3BfException {
    try {
        ObjectMapper jsonMapper = new ObjectMapper();
        // 配置Jackson直接访问字段，包括父类的字段
        jsonMapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);
        // 可选：关闭未知字段报错（如果还有其他未映射字段），但优先解决deleteFile的问题
        // jsonMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
        return jsonMapper.readValue(content, clazz);
    } catch(IOException e) {
        throw new MB3BfException("Cannot decode action content", e);
    }
}

3. 父类与子类的继承关系未被Jackson正确识别 #

如果父类是抽象类，或未通过注解明确子类关系，Jackson可能无法关联父类属性到子类实例：

解决示例：
在父类上添加@JsonTypeInfo和@JsonSubTypes注解，明确子类继承关系：

@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.PROPERTY, property = "type")
@JsonSubTypes({
    @JsonSubTypes.Type(value = FileTransferStructureExecution.class, name = "TXT")
})
public class FileTransferStructure {
    // ... 父类属性
}

注：这里的property = "type"要对应JSON中的type字段值，确保Jackson能正确识别子类类型并加载父类属性。

4. 属性名拼写或大小写不匹配 #

仔细检查父类的属性名是否为deleteFile（注意大小写：F是大写），JSON中的字段是"deleteFile"，如果父类属性名写成deletefile（小写f），就会导致匹配失败。

解决：严格保持属性名与JSON字段名一致，或用@JsonProperty("deleteFile")强制指定映射关系。

5. ObjectMapper重复创建导致配置丢失 #

当前代码每次调用parseJson都会新建ObjectMapper实例，若后续需要添加全局配置（比如继承支持），会导致配置无法复用。建议将ObjectMapper改为单例：

解决示例：

// 全局单例ObjectMapper
private static final ObjectMapper JSON_MAPPER = new ObjectMapper();

static {
    // 一次性配置所需特性
    JSON_MAPPER.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);
}

protected <C> C parseJson(String content, Class<C> clazz) throws MB3BfException {
    try {
        return JSON_MAPPER.readValue(content, clazz);
    } catch(IOException e) {
        throw new MB3BfException("Cannot decode action content", e);
    }
}

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