将Protobuf对象存入Firestore时遇maxInboundMessageSize错误的解决咨询

错误原因 #

这个java.lang.NoSuchFieldError: maxInboundMessageSize异常并不是Firestore不支持Protobuf对象导致的，本质是gRPC依赖版本冲突：
你父POM指定了gRPC版本1.41.0，但Firebase SDK（尤其是Firestore相关依赖）可能内置了其他版本的gRPC组件，导致编译时使用的gRPC类（包含maxInboundMessageSize字段）和运行时加载的类版本不一致，进而抛出字段找不到的错误。

解决步骤 #

1. 排查依赖冲突 #

在项目根目录执行Maven命令，查看所有gRPC相关依赖的版本，找出冲突项：

mvn dependency:tree -Dincludes=io.grpc

重点看输出里Firebase相关依赖引入的gRPC版本，是否和你指定的1.41.0不一致。

2. 统一gRPC版本 #

在父POM的<dependencyManagement>块中强制统一所有gRPC相关依赖的版本，覆盖Firebase SDK自带的版本：

<dependencyManagement>
  <dependencies>
    <!-- 统一gRPC核心组件版本 -->
    <dependency>
      <groupId>io.grpc</groupId>
      <artifactId>grpc-netty-shaded</artifactId>
      <version>${grpc.version}</version>
    </dependency>
    <dependency>
      <groupId>io.grpc</groupId>
      <artifactId>grpc-protobuf</artifactId>
      <version>${grpc.version}</version>
    </dependency>
    <dependency>
      <groupId>io.grpc</groupId>
      <artifactId>grpc-stub</artifactId>
      <version>${grpc.version}</version>
    </dependency>
    <!-- 其他gRPC组件如grpc-services等，也需按需添加并统一版本 -->
  </dependencies>
</dependencyManagement>

确保${grpc.version}已在POM中定义为1.41.0。

3. 规范Protobuf转JSON的流程 #

虽然错误和Firestore支持无关，但要确保Protobuf转JSON的过程没问题，推荐用官方工具类：

// 用Protobuf官方工具将User对象转为JSON字符串
String userJson = com.google.protobuf.util.JsonFormat.printer().print(protobufUser);
// 转为Firestore可直接处理的Map结构
Map<String, Object> userData = new com.google.gson.Gson().fromJson(userJson, new com.google.gson.reflect.TypeToken<Map<String, Object>>(){}.getType());
// 存入Firestore
firestore.collection("users").document(uid).set(userData);

4. 清理并重新构建 #

执行以下命令清理旧依赖并重新构建项目，确保版本统一生效：

mvn clean install

补充提示 #

如果统一版本后仍有问题，可尝试将gRPC版本升级到和protobuf-java3.19.0兼容性更好的稳定版本（比如1.48.1），同时确认Firebase SDK版本和gRPC版本的兼容性。

内容的提问来源于stack exchange，提问作者Arnob