You need to enable JavaScript to run this app. SpringBoot中Jackson2反序列化纯字符串application/json响应配置问题
优惠活动
大模型
产品
解决方案
定价
更多

SpringBoot中Jackson2反序列化纯字符串application/json响应配置问题

解决方案

报错核心原因:Jackson反序列化时遇到JSON字符串字面量(而非JSON对象),无法将字符串直接映射到自定义类,缺少对应的字符串入参构造方法或适配逻辑。

以下是3种可行的配置方案,可根据业务场景选择:

方案1:最小改动适配(无需修改全局配置)

直接给你的自定义类添加字符串参数构造方法,并用@JsonCreator注解标记让Jackson识别即可:

public class CustomClass {
    private String message;

    // 新增字符串入参构造方法
    @JsonCreator
    public CustomClass(String message) {
        this.message = message;
    }

    // 保留原有构造方法、getter、setter逻辑
}

方案2:全局配置Jackson反序列化特性

如果不想改动业务类,直接修改你现有的MappingJackson2HttpMessageConverter配置,扩展ObjectMapper的反序列化能力:

import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.http.MediaType;
import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public List<HttpMessageConverter<?>> getConverters() {
    List<HttpMessageConverter<?>> converters = new ArrayList<>();
    
    MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
    converter.setSupportedMediaTypes(Collections.singletonList(MediaType.ALL));
    
    // 新增ObjectMapper适配配置
    ObjectMapper objectMapper = converter.getObjectMapper();
    // 允许空字符串转成null对象
    objectMapper.enable(DeserializationFeature.ACCEPT_EMPTY_STRING_AS_NULL_OBJECT);
    // 允许单个基础值自动适配接收类型
    objectMapper.enable(DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY);
    converter.setObjectMapper(objectMapper);
    
    converters.add(converter);
    return converters;
}

方案3:自定义全局反序列化器(兼容混合返回场景)

如果外部API存在有时返回JSON对象、有时返回字符串的混合情况,可以注册自定义反序列化器做统一适配:

  1. 先实现自定义反序列化逻辑:
import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.deser.std.StdDeserializer;
import java.io.IOException;

public class CustomClassDeserializer extends StdDeserializer<CustomClass> {
    public CustomClassDeserializer() {
        super(CustomClass.class);
    }

    @Override
    public CustomClass deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        // 输入是字符串时直接封装为对象
        if (p.isTextual()) {
            CustomClass result = new CustomClass();
            result.setMessage(p.getText()); // 按业务逻辑赋值属性
            return result;
        }
        // 输入是标准JSON对象时走默认反序列化逻辑
        return p.readValueAs(CustomClass.class);
    }
}
  1. 将反序列化器注册到转换器中:
// 在getConverters方法中新增以下配置
ObjectMapper objectMapper = converter.getObjectMapper();
SimpleModule module = new SimpleModule();
module.addDeserializer(CustomClass.class, new CustomClassDeserializer());
objectMapper.registerModule(module);
converter.setObjectMapper(objectMapper);

内容的提问来源于stack exchange,提问作者NotSteve

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 17:48:03