解决dubbo3使用protobuf序列化问题

最新推荐文章于 2026-04-30 11:47:26 发布

原创最新推荐文章于 2026-04-30 11:47:26 发布 · 3.6k 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#java #rpc #微服务

Dubbo 专栏收录该内容

1 篇文章

订阅专栏

本文介绍了作者在尝试使用dubbo3新版本时遇到的protobuf序列化问题。项目采用springboot、dubbo3、nacos和protobuf作为基础架构。在遵循官方文档进行配置后，客户端运行时出现错误。通过深入研究，作者发现解决方案在于添加缺失的依赖，具体解决办法可在官方文档和提供的GitHub项目源码中找到。

背景

dubbo3是今年新推出的革命性版本，之前使用过dubbo2，对dubbo3比较好奇，今天就初次尝鲜。本次项目架构：

springboot 基础脚手架
dubbo3 核心服务框架
nacos 注册中心
protobuf 传输协议

问题

按照官方文档教程编写，customer端运行时报以下错误信息：

Caused by: java.lang.IllegalArgumentException: This serialization only supports google protobuf objects, current object class is: java.lang.String
	at org.apache.dubbo.common.serialize.protobuf.support.GenericProtobufObjectOutput.writeObject(GenericProtobufObjectOutput.java:115)
	at org.apache.dubbo.rpc.protocol.dubbo.DubboCodec.encodeRequestData(DubboCodec.java:207)
	at org.apache.dubbo.remoting.exchange.codec.ExchangeCodec.encodeRequest(ExchangeCodec.java:259)
	at org.apache.dubbo.remoting.exchange.codec.ExchangeCodec.encode(ExchangeCodec.java:71)
	at org.apache.dubbo.rpc.protocol.dubbo.DubboCountCodec.encode(DubboCountCodec.java:47)
	at org.apache.dubbo.remoting.transport.netty4.NettyCodecAdapter$InternalEncoder.encode(NettyCodecAdapter.java:69)
	at io.netty.handler.codec.MessageToByteEncoder.write(MessageToByteEncoder.java:107)
	... 21 more

解决

一开始以为是dubbo配置的问题，尝试多次无果后，还是在官网文档中发现的解决方案，原来是缺少依赖了。按文档说明，添加以下依赖即可：

<dependency>
   <groupId>org.apache.dubbo</groupId>
   <artifactId>dubbo-metadata-definition-protobuf</artifactId>
   <version>${dubbo.version}</version>
</dependency>