MyBatis-Plus中Page.records默认值引发的序列化问题解析
问题背景
在使用MyBatis-Plus进行分页查询时,Page对象的records字段默认被初始化为Collections.emptyList()。这个设计在大多数情况下工作良好,但在某些特定场景下可能会引发问题。
问题现象
当开发者使用Dubbo进行跨服务调用,并且使用fastjson2进行序列化/反序列化时,如果Page对象中的records字段保持默认的空列表状态,在反序列化过程中可能会抛出UnsupportedOperationException异常。
技术分析
1. 默认值设计
MyBatis-Plus中Page类的records字段默认被设置为Collections.emptyList(),这是一个不可变(immutable)的空列表实现。这种设计有以下优点:
- 节省内存,所有空列表共享同一个实例
- 避免不必要的对象创建
- 明确表示这是一个不可修改的列表
2. 问题根源
问题出现在fastjson2的反序列化过程中。当fastjson2尝试反序列化Page对象时,它会尝试使用List.add()方法向records列表中添加元素。由于Collections.emptyList()是不可变列表,任何修改操作都会抛出UnsupportedOperationException。
3. 复现条件
这个问题需要同时满足以下条件才会出现:
- 使用Dubbo进行跨服务调用
- 使用fastjson2作为序列化工具
- Page对象的records字段保持默认值(空列表)
- 反序列化时尝试修改records列表
解决方案探讨
方案1: 修改MyBatis-Plus默认值
将Page.records的默认值从Collections.emptyList()改为new ArrayList<>()。这种修改可以:
- 避免反序列化时的异常
- 保持列表的可修改性
但需要考虑的副作用:
- 每次创建Page对象都会新建一个ArrayList实例
- 可能影响现有依赖于不可变列表特性的代码
方案2: 升级fastjson2
fastjson2的最新版本可能已经修复了这个问题。开发者可以尝试升级到最新版本,看是否能解决序列化问题。
方案3: 自定义Page实现
开发者可以创建自己的Page子类,覆盖默认的records字段初始化逻辑,根据实际需求选择合适的列表实现。
最佳实践建议
- 对于需要跨服务传输的Page对象,建议在服务边界处进行转换,使用可修改的列表实现
- 考虑使用DTO模式,避免直接传输MyBatis-Plus的内部数据结构
- 如果性能不是关键因素,可以使用new ArrayList<>()作为默认值来避免潜在问题
总结
MyBatis-Plus中Page.records默认值的设计在大多数情况下是合理且高效的,但在特定的序列化场景下可能会引发问题。开发者需要根据实际应用场景选择合适的解决方案,权衡性能、安全性和兼容性等因素。理解这些底层机制有助于开发者更好地使用MyBatis-Plus框架,并避免潜在的问题。
- QQwen3-Next-80B-A3B-InstructQwen3-Next-80B-A3B-Instruct 是一款支持超长上下文(最高 256K tokens)、具备高效推理与卓越性能的指令微调大模型00
- QQwen3-Next-80B-A3B-ThinkingQwen3-Next-80B-A3B-Thinking 在复杂推理和强化学习任务中超越 30B–32B 同类模型,并在多项基准测试中优于 Gemini-2.5-Flash-Thinking00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~0266cinatra
c++20实现的跨平台、header only、跨平台的高性能http库。C++00AI内容魔方
AI内容专区,汇集全球AI开源项目,集结模块、可组合的内容,致力于分享、交流。02- HHunyuan-MT-7B腾讯混元翻译模型主要支持33种语言间的互译,包括中国五种少数民族语言。00
GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile06
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
热门内容推荐
最新内容推荐
项目优选









