gRPC Java Protobuf代码生成异常：RpcChannel替代io.grpc.Channel且无服务基类

核心原因 #

你遇到的问题根源在于两个关键错误：

1. 错误启用原生Protobuf通用服务：option java_generic_services = true; 是原生Protobuf的旧特性，生成的是基于RpcChannel的传统服务类，而非gRPC所需的io.grpc.Channel实现。
2. Maven插件未配置gRPC代码生成：仅依赖原生Protobuf插件不会生成gRPC专属的服务基类（如PanelServiceImplBase），必须启用gRPC的代码生成扩展。

解决步骤 #

1. 修改.proto文件 #

移除option java_generic_services = true;，保留gRPC所需的配置即可：

syntax = "proto3";
package agent;

option java_multiple_files = true;
option java_package = "grpc";
option java_outer_classname = "AgentServerProto";
option objc_class_prefix = "Utm";

// 确保服务定义正确，示例：
service PanelService {
  rpc SomeMethod(YourRequest) returns (YourResponse);
}

// 消息定义示例
message YourRequest {
  string data = 1;
}

message YourResponse {
  string result = 1;
}

2. 正确配置Maven插件 #

在pom.xml中配置protobuf-maven-plugin，添加gRPC代码生成器扩展，并指定与你的gRPC版本匹配的插件版本：

<build>
  <plugins>
    <plugin>
      <groupId>org.xolstice.maven.plugins</groupId>
      <artifactId>protobuf-maven-plugin</artifactId>
      <version>0.6.1</version> <!-- 与grpc 1.55.1兼容的版本 -->
      <configuration>
        <protocArtifact>com.google.protobuf:protoc:3.23.2:exe:${os.detected.classifier}</protocArtifact>
        <pluginId>grpc-java</pluginId>
        <pluginArtifact>io.grpc:protoc-gen-grpc-java:1.55.1:exe:${os.detected.classifier}</pluginArtifact>
        <outputDirectory>${project.build.directory}/generated-sources/protobuf/java</outputDirectory>
        <clearOutputDirectory>true</clearOutputDirectory>
      </configuration>
      <executions>
        <execution>
          <goals>
            <goal>compile</goal> <!-- 生成Protobuf消息类 -->
            <goal>compile-custom</goal> <!-- 生成gRPC Stub和服务基类 -->
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

注意：protoc版本必须与protobuf-java版本（3.23.2）完全一致，protoc-gen-grpc-java版本必须与你的gRPC依赖版本（1.55.1）一致。

3. 执行代码生成 #

运行Maven命令清理并编译项目：

mvn clean compile

验证结果 #

编译完成后，你将在target/generated-sources/protobuf/java和target/generated-sources/protobuf/grpc-java目录下看到：

• 使用io.grpc.Channel的Stub类（如PanelServiceStub）
• 服务实现基类（如PanelServiceImplBase）

额外排查点 #

• 确认你的.proto文件中存在正确的service定义，如果没有服务声明，不会生成服务基类。
• 检查Maven依赖是否完整，确保grpc-protobuf、grpc-stub、grpc-netty-shaded的版本统一为1.55.1。

内容的提问来源于stack exchange，提问作者Jorge Dieguez Perez