Dubbo RPC 序列化问题记录

Dubbo RPC 序列化问题:List.of() 导致的 "Fail to decode request" 错误

问题背景

在开发过程中,遇到了一个 Dubbo RPC 调用失败的问题。当在请求参数中设置 revises 字段时,会出现以下错误:

复制代码
com.alibaba.dubbo.rpc.RpcException: Failed to invoke the method jobSearch in the service com.techwolf.oceanus.api.search.job.JobSearchService$Iface. 
Tried 1 times of the providers [10.57.121.172:28000] (1/1) from the registry ceres-qa.weizhipin.com:8091 on the consumer 172.16.26.127 using the dubbo version 2.6.17-ZP. 
Last error is: Failed to invoke remote method: jobSearch, provider: dubbo://10.57.121.172:28000/com.techwolf.oceanus.api.search.job.JobSearchService$Iface
...
Caused by: com.alibaba.dubbo.remoting.RemotingException: Fail to decode request due to: RpcInvocation [methodName=jobSearch, parameterTypes=[class com.techwolf.oceanus.api.search.job.JobSearchRequest], arguments=null, attachments={path=com.techwolf.oceanus.api.search.job.JobSearchService$Iface, input=1650, dubbo=2.0.2, version=1.0.0}, attributes={serialization_id=2}]

问题分析

1. 错误现象

  • 当不设置 revises 参数时,RPC 调用正常
  • 当设置 revises 参数时,出现序列化失败错误
  • 错误信息显示 "Fail to decode request",表明是序列化/反序列化问题

2. 代码定位

问题出现在 buildEXTFilter 方法中:

java 复制代码
private Revise buildEXTFilter(long positionId, long parentId) {
    ReviseTag curTag = new ReviseTag();
    curTag.setCode("posi:" + positionId);
    ReviseTag parentTag = new ReviseTag();
    parentTag.setCode("posi:" + parentId);
    parentTag.setContents(List.of(curTag));  // 问题所在
    ReviseTag rootTag = new ReviseTag();
    rootTag.setContents(List.of(parentTag)); // 问题所在
    rootTag.setCode("posi:1");
    Map<ReviseType, ReviseContent> reviseContents = new HashMap<>();
    ReviseContent content = new ReviseContent();
    content.setType(ReviseType.EXT_FILTER);
    content.setTags(List.of(rootTag));       // 问题所在
    reviseContents.put(ReviseType.EXT_FILTER, content);
    Revise revise = new Revise();
    revise.setReviseContents(reviseContents);
    return revise;
}

3. 根本原因

  • 使用了 List.of() 方法创建列表
  • List.of() 是 Java 9 引入的方法,返回不可变列表
  • Dubbo 使用 Hessian2 序列化,对不可变列表的序列化支持存在问题
  • 不可变列表在某些序列化场景下可能导致序列化失败

解决方案

方案一:使用 Arrays.asList() 替换 List.of()

java 复制代码
private Revise buildEXTFilter(long positionId, long parentId) {
    ReviseTag curTag = new ReviseTag();
    curTag.setCode("posi:" + positionId);
    ReviseTag parentTag = new ReviseTag();
    parentTag.setCode("posi:" + parentId);
    parentTag.setContents(Arrays.asList(curTag));  // 修改后
    ReviseTag rootTag = new ReviseTag();
    rootTag.setContents(Arrays.asList(parentTag)); // 修改后
    rootTag.setCode("posi:1");
    Map<ReviseType, ReviseContent> reviseContents = new HashMap<>();
    ReviseContent content = new ReviseContent();
    content.setType(ReviseType.EXT_FILTER);
    content.setTags(Arrays.asList(rootTag));       // 修改后
    reviseContents.put(ReviseType.EXT_FILTER, content);
    Revise revise = new Revise();
    revise.setReviseContents(reviseContents);
    return revise;
}

方案二:使用 new ArrayList<>() 创建可变列表

java 复制代码
private Revise buildEXTFilter(long positionId, long parentId) {
    ReviseTag curTag = new ReviseTag();
    curTag.setCode("posi:" + positionId);
    ReviseTag parentTag = new ReviseTag();
    parentTag.setCode("posi:" + parentId);
    parentTag.setContents(new ArrayList<>(Arrays.asList(curTag)));
    ReviseTag rootTag = new ReviseTag();
    rootTag.setContents(new ArrayList<>(Arrays.asList(parentTag)));
    rootTag.setCode("posi:1");
    Map<ReviseType, ReviseContent> reviseContents = new HashMap<>();
    ReviseContent content = new ReviseContent();
    content.setType(ReviseType.EXT_FILTER);
    content.setTags(new ArrayList<>(Arrays.asList(rootTag)));
    reviseContents.put(ReviseType.EXT_FILTER, content);
    Revise revise = new Revise();
    revise.setReviseContents(reviseContents);
    return revise;
}

技术要点

1. List.of() vs Arrays.asList() 对比

特性 List.of() Arrays.asList()
Java 版本 Java 9+ Java 1.2+
可变性 不可变 半可变(不支持结构修改)
序列化兼容性 部分场景有问题 兼容性更好
性能 略好 略差
空值支持 不支持 null 支持 null

2. Dubbo 序列化机制

  • Dubbo 默认使用 Hessian2 序列化
  • Hessian2 对某些 Java 集合类型的序列化支持有限
  • 不可变集合在某些场景下可能导致序列化失败

3. 最佳实践建议

  • 在 Dubbo RPC 调用中,优先使用 Arrays.asList()new ArrayList<>()
  • 避免在序列化场景中使用 List.of()Set.of() 等不可变集合
  • 如果必须使用不可变集合,需要测试序列化兼容性

验证结果

修改后重新测试:

  • ✅ RPC 调用成功
  • ✅ 序列化/反序列化正常
  • ✅ 功能逻辑保持不变

总结

这个问题提醒我们在使用 Java 新特性时要注意兼容性问题,特别是在分布式系统、RPC 调用等场景下。List.of() 虽然提供了更好的性能和不可变性保证,但在某些序列化场景下可能存在兼容性问题。在实际开发中,需要根据具体的使用场景选择合适的集合创建方式。

相关链接


记录时间:2025年1月
问题类型:Dubbo RPC 序列化兼容性问题
解决状态:已解决

相关推荐
zz9602261 小时前
Windows Server存储池,虚拟磁盘在系统启动后不自动连接需要手动连接
windows
火车叨位去19497 小时前
用Java实现rpc的逻辑和流程图和核心技术与难点分析
java·rpc·流程图
吳所畏惧7 小时前
NVM踩坑实录:配置了npm的阿里云cdn之后,下载nodejs老版本(如:12.18.4)时,报404异常,下载失败的问题解决
前端·windows·阿里云·npm·node.js·batch命令
leese2337 小时前
FreeMarker模板引擎
windows
love530love8 小时前
命令行创建 UV 环境及本地化实战演示—— 基于《Python 多版本与开发环境治理架构设计》的最佳实践
开发语言·人工智能·windows·python·conda·uv
呉師傅8 小时前
佳能iR-ADV C5560复印机如何扫描文件到电脑
运维·网络·windows·计算机外设·电脑
程序视点8 小时前
【最新专业评测】PDF Reducer专业版:85%超高压缩率的PDF压缩神器|Windows最佳PDF压缩工具推荐
windows
qyhua12 小时前
Windows 平台源码部署 Dify教程(不依赖 Docker)
人工智能·windows·python
女程序猿!!!13 小时前
网址收集总结
windows
学Linux的语莫15 小时前
k8s的nodeport和ingress
网络·rpc·kubernetes