Spring Boot 3.x整合gRPC：从Protobuf定义到微服务通信的工程实践

微服务架构中，服务间通信选型直接影响系统性能和可维护性。REST API开发便捷但序列化开销大，gRPC基于Protobuf二进制协议，吞吐量高出REST 3-8倍，且自带强类型约束和代码生成能力。Spring Boot 3.x与gRPC的整合已趋于成熟，本文覆盖从Protobuf定义到双向流式通信的完整工程实践。

Protobuf IDL定义与代码生成配置

先定义服务接口和数据结构。以订单服务为例，定义OrderService包含一元调用GetOrder、服务端流式ListOrders和双向流式StreamOrderUpdates三种RPC模式。Maven中配置protobuf-maven-plugin自动生成Java类，指定protoc和grpc-java代码生成插件版本。

Spring Boot 3.x集成grpc-spring-boot-starter

引入grpc-spring-boot-starter依赖，自动配置gRPC Server和Client：

// build.gradle
implementation 'net.devh:grpc-spring-boot-starter:3.1.0.RELEASE'
implementation 'io.grpc:grpc-protobuf:1.60.0'
implementation 'io.grpc:grpc-stub:1.60.0'

application.yaml配置gRPC Server端口、keep-alive参数和客户端连接地址：

grpc:
  server:
    port: 9090
    enable-keep-alive: true
    keep-alive-time: 30s
    max-inbound-message-size: 10MB
  client:
    order-service:
      address: 'static://127.0.0.1:9090'
      negotiation-type: plaintext
      enable-keep-alive: true

服务端实现与拦截器

使用@GrpcService注解标记服务实现类，继承自动生成的Grpc服务基类。重写RPC方法，在方法中调用业务层逻辑。错误处理通过gRPC Status对象返回，而非抛出异常。服务端拦截器用于认证、日志和指标采集。通过@GrpcInterceptor注解注册，在interceptCall方法中提取Metadata中的认证令牌，校验后决定放行或拒绝。

@GrpcService
public class OrderGrpcService extends OrderServiceGrpc.OrderServiceImplBase {

    private final OrderRepository orderRepository;
    private final OrderMapper orderMapper;

    @Override
    public void getOrder(OrderRequest request,
                        StreamObserver<OrderResponse> responseObserver) {
        Order order = orderRepository.findById(request.getOrderId())
            .orElseThrow(() -> Status.NOT_FOUND
                .withDescription("订单不存在")
                .asRuntimeException());
        responseObserver.onNext(orderMapper.toProto(order));
        responseObserver.onCompleted();
    }
}

客户端调用与流式通信

gRPC提供三种客户端Stub：BlockingStub（同步阻塞）、FutureStub（异步Future）、Stub（异步StreamObserver）。一元调用用BlockingStub，流式调用必须用异步Stub。流式调用适合实时数据推送场景，如订单状态变更通知。

服务治理：超时、重试与负载均衡

gRPC内置了Deadline机制，比HTTP超时更精确。客户端通过withDeadlineAfter设置单次调用超时。负载均衡方面，gRPC默认使用pick_first策略（单连接），生产环境需切换为round_robin。配合NameResolver解析服务发现（如Nacos/Consul）。对于链路追踪，在拦截器中注入OpenTelemetry上下文，将trace_id通过gRPC Metadata传递，实现跨服务调用链路贯穿。

与REST API共存的最佳实践

微服务架构中，外部网关暴露REST，内部服务间通信走gRPC。Spring Boot可同时监听HTTP和gRPC两个端口。外部请求经Gateway转换为gRPC调用内部服务。核心约束：对外REST接口的变更需保持向后兼容，内部gRPC接口通过Protobuf版本管理实现向前兼容——新字段使用新编号，旧字段绝不修改类型或删除。