解决异常:fastjson 序列化与反序列化集合时出现问题

2025-09-16后端4 分钟109 次阅读
AI 摘要鱼粮不足,AI 今天先歇着 · 正文在下面

问题背景

在实现配送设置业务时,遇到一个比较奇怪的情况:

  • 如果我在配置服务里直接调用接口,本地测试一切正常。
  • 但当 订单服务 通过 OpenFeign 调用该接口时,却报了 序列化异常,接口调用失败。

问题接口返回的 VO 如下(报错方法:getDeliveryTypeList())

java 复制代码
@EqualsAndHashCode(callSuper = true)
@Data
public class HourlyStoreDeliveryConfigVO extends HourlyStoreDeliveryConfig {

    /**
     * 公司承担配送费比例(0.00~1.00,用于计算使用)
     */
    public BigDecimal getCompanyCostRatioDecimal() {
        if (getCompanyCostRatio() == null) {
            return BigDecimal.ZERO;
        }
        return BigDecimal.valueOf(getCompanyCostRatio()).multiply(new BigDecimal("0.01"));
    }

    /**
     * 基础运费(默认值8元)
     */
    @Override
    public BigDecimal getBaseDeliveryFee() {
        if (super.getBaseDeliveryFee() == null) {
            return new BigDecimal("8");
        }
        return super.getBaseDeliveryFee();
    }

    /**
     * 免配送费订单金额门槛(默认值50元)
     */
    @Override
    public BigDecimal getFreeDeliveryAmountThreshold() {
        if (super.getFreeDeliveryAmountThreshold() == null) {
            return new BigDecimal("50");
        }
        return super.getFreeDeliveryAmountThreshold();
    }

    /**
     * 配送范围(默认5公里)
     */
    @Override
    public BigDecimal getMaxDeliveryDistance() {
        if (super.getMaxDeliveryDistance() == null) {
            return new BigDecimal("5");
        }
        return super.getMaxDeliveryDistance();
    }

    /**
     * (全局配置)配送方式,默认商家配送
     */
    public List<String> getDeliveryTypeList() {
        if (StrUtil.isBlank(getDeliveryTypesStr())) {
            return Collections.singletonList("storeDelivery");
        }
        return JSON.parseArray(getDeliveryTypesStr(), String.class);
    }

    /**
     * 配送时间段
     */
    public List<String> getDeliveryTimeSlotList() {
        if (StrUtil.isBlank(getDeliveryTimeSlotsStr())) {
            return Collections.emptyList();
        }
        return JSON.parseArray(getDeliveryTimeSlotsStr(), String.class);
    }

    /**
     * 选择的时间范围(平铺时间范围,HH:mm,用户端使用)
     */
    public List<String> getSelectDeliveryTimeList() {
        List<String> deliveryTimeSlotList = getDeliveryTimeSlotList();
        if (CollUtil.isEmpty(deliveryTimeSlotList)) {
            return Collections.emptyList();
        }
        List<String> result = new LinkedList<>();
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("HH:mm");
        DateTimeFormatter parseFormatter = DateTimeFormatter.ofPattern("HH:mm:ss");
        deliveryTimeSlotList.sort(String::compareTo);
        for (String slot : deliveryTimeSlotList) {
            String[] parts = slot.split("-");
            if (parts.length != 2) {
                continue; // 非法时间段跳过
            }
            // 这里解析时还是用带秒格式,避免报错
            LocalTime start = LocalTime.parse(parts[0], parseFormatter);
            LocalTime end = LocalTime.parse(parts[1], parseFormatter);

            while (start.isBefore(end)) {
                LocalTime next = start.plusHours(1);
                if (next.isAfter(end)) {
                    next = end;
                }
                result.add(start.format(formatter) + "-" + next.format(formatter));
                start = next;
            }
        }
        return result;
    }
}

问题复现

项目序列化配置:

  • fastjson

示例服务方法:

  • 配置服务(获取通用配送设置)
  • 订单服务(下单接口)

当订单服务通过 Feign 调用配置服务时,会经历一次 序列化 + 反序列化:

  1. 配置服务返回对象 → fastjson 序列化成 JSON
  2. 订单服务收到结果 → fastjson 再反序列化为 VO

为了模拟这个过程,我写了个简单的方法:

java 复制代码
/**
 * 获取通用配送设置
 *
 * @return 配置列表
 */
@GetMapping("/getCommonSetting")
public Resp<HourlyStoreDeliveryConfigVO> getCommonSetting() {
    HourlyStoreDeliveryConfigVO commonDeliveryConfigs = new HourlyStoreDeliveryConfigVO();
    HourlyStoreDeliveryConfigVO commonDeliveryConfigs1 = JSON.parseObject(JSON.toJSONString(commonDeliveryConfigs), HourlyStoreDeliveryConfigVO.class);
    return Resp.success(commonDeliveryConfigs1);
}

调接口报错
image.png

java 复制代码
com.alibaba.fastjson.JSONException: set property error, com.rlbsx.configuration.vo.HourlyStoreDeliveryConfigVO#deliveryTypeList
	at com.alibaba.fastjson.parser.deserializer.FieldDeserializer.setValue(FieldDeserializer.java:219)
	at com.alibaba.fastjson.parser.deserializer.ArrayListTypeFieldDeserializer.parseField(ArrayListTypeFieldDeserializer.java:77)
	at com.alibaba.fastjson.parser.deserializer.JavaBeanDeserializer.parseField(JavaBeanDeserializer.java:1278)
	at com.alibaba.fastjson.parser.deserializer.JavaBeanDeserializer.deserialze(JavaBeanDeserializer.java:893)
	at com.alibaba.fastjson.parser.deserializer.JavaBeanDeserializer.deserialze(JavaBeanDeserializer.java:291)
	at com.alibaba.fastjson.parser.DefaultJSONParser.parseObject(DefaultJSONParser.java:703)
	at com.alibaba.fastjson.JSON.parseObject(JSON.java:394)
	at com.alibaba.fastjson.JSON.parseObject(JSON.java:298)
	at com.alibaba.fastjson.JSON.parseObject(JSON.java:588)
	at com.rlbsx.configuration.controller.HourlyStoreDeliveryConfigController.getCommonSetting(HourlyStoreDeliveryConfigController.java:47)
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
	at java.lang.reflect.Method.invoke(Method.java:498)
	at org.springframework.web.method.support.InvocableHandlerMethod.doInvoke(InvocableHandlerMethod.java:190)
	at org.springframework.web.method.support.InvocableHandlerMethod.invokeForRequest(InvocableHandlerMethod.java:138)
	at org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod.invokeAndHandle(ServletInvocableHandlerMethod.java:105)
	at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.invokeHandlerMethod(RequestMappingHandlerAdapter.java:878)
	at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.handleInternal(RequestMappingHandlerAdapter.java:792)
	at org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter.handle(AbstractHandlerMethodAdapter.java:87)
	at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:1040)
	at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:943)
	at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:1006)
	at org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:898)
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:626)
	at org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:883)
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:733)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:231)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:53)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at com.github.xiaoymin.knife4j.spring.filter.ProductionSecurityFilter.doFilter(ProductionSecurityFilter.java:45)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at com.rlbsx.common.filter.HttpServletRequestReplacedFilter.doFilter(HttpServletRequestReplacedFilter.java:30)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at com.rlbsx.common.filter.XssFilter.doFilter(XssFilter.java:23)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.springframework.web.filter.RequestContextFilter.doFilterInternal(RequestContextFilter.java:100)
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:119)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.springframework.web.filter.FormContentFilter.doFilterInternal(FormContentFilter.java:93)
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:119)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.springframework.boot.actuate.metrics.web.servlet.WebMvcMetricsFilter.doFilterInternal(WebMvcMetricsFilter.java:93)
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:119)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.springframework.web.filter.CharacterEncodingFilter.doFilterInternal(CharacterEncodingFilter.java:201)
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:119)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:202)
	at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:96)
	at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:541)
	at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:139)
	at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:92)
	at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:74)
	at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:343)
	at org.apache.coyote.http11.Http11Processor.service(Http11Processor.java:373)
	at org.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:65)
	at org.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:868)
	at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1589)
	at org.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:49)
	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
	at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
	at java.lang.Thread.run(Thread.java:750)
Caused by: java.lang.UnsupportedOperationException: null
	at java.util.AbstractList.remove(AbstractList.java:161)
	at java.util.AbstractList$Itr.remove(AbstractList.java:374)
	at java.util.AbstractList.removeRange(AbstractList.java:571)
	at java.util.AbstractList.clear(AbstractList.java:234)
	at com.alibaba.fastjson.parser.deserializer.FieldDeserializer.setValue(FieldDeserializer.java:150)
	... 72 common frames omitted
2025-09-16 11:56:12.839 [TID: N/A] [http-nio-18003-exec-3] DEBUG c.r.c.i.AbstractInjectInterceptor -remove context 

下面是序列化出现问题处的具体源码
image.png

问题分析

通过堆栈定位到 fastjson 的源码,关键逻辑如下:

java 复制代码
Collection collection = (Collection) field.get(object);
if (collection != null && value != null) {
    if (collection == Collections.emptySet()
            || collection == Collections.emptyList()
            || collection.getClass().getName().startsWith("java.util.Collections$Unmodifiable")) {
        // skip
        return;
    }
    collection.clear();
    collection.addAll((Collection) value);
}

可以看到:

  • fastjson 在反序列化时,如果字段是集合,会先尝试清空再 addAll。
  • 但它对 不可变集合(emptyList()、emptySet()、UnmodifiableXXX)做了跳过处理。
  • 问题是我返回的是 Collections.singletonList("storeDelivery"),它同样是 不可变集合,但 fastjson 并没有特殊处理,结果调用 clear() 时抛出了 UnsupportedOperationException。

解决方案

只要避免返回不可变集合即可。修改方法如下:

java 复制代码
/**
 * (全局配置)配送方式,默认商家配送
 */
public List<String> getDeliveryTypeList() {
    if (StrUtil.isBlank(getDeliveryTypesStr())) {
        return new ArrayList<>(Collections.singletonList("storeDelivery"));
    }
    return JSON.parseArray(getDeliveryTypesStr(), String.class);
}

再次调用,序列化 + 反序列化流程正常,问题解决 ✅
image.png

总结

这次问题的根因在于:

  • Feign 跨服务调用会涉及对象的序列化和反序列化,所以不能只在单服务里测试。
  • fastjson 对集合的反序列化逻辑存在限制,某些不可变集合(如 singletonList)会在 clear() 时触发异常。
觉得有用就点个赞,不用登录也能读

评论

0 条
登录 之后才能评论
—
还没有评论,来说第一句