解决异常:fastjson 序列化与反序列化集合时出现问题
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 调用配置服务时,会经历一次 序列化 + 反序列化:
- 配置服务返回对象 → fastjson 序列化成 JSON
- 订单服务收到结果 → 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);
}
调接口报错

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
下面是序列化出现问题处的具体源码

问题分析
通过堆栈定位到 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);
}
再次调用,序列化 + 反序列化流程正常,问题解决 ✅

总结
这次问题的根因在于:
- Feign 跨服务调用会涉及对象的序列化和反序列化,所以不能只在单服务里测试。
- fastjson 对集合的反序列化逻辑存在限制,某些不可变集合(如 singletonList)会在 clear() 时触发异常。
评论
0 条—
还没有评论,来说第一句