Spring gRPC

Spring Boot integration for gRPC. Provides autoconfiguration for gRPC servers and clients, channel factories, interceptors, health/reflection services, observability, and Spring Security integration.

• Current version: 1.1.0-M1
• Requires Spring Boot 4.1.x
• Default server port: 9090

Quick Start

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework.grpc</groupId>
      <artifactId>spring-grpc-dependencies</artifactId>
      <version>1.1.0-M1</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Create a BindableService bean annotated with @Service to expose a gRPC service. Inject a GrpcChannelFactory to build client stubs.

Contents

• Getting Started — project setup, proto definition, first service, running and testing
• Server — server factories (Netty, servlet, in-process), interceptors, reflection, health, observability, exception handling, security (TLS/mTLS, Spring Security, OAuth2)
• Client — channel factory, @ImportGrpcClients, customizers, interceptors, security (mTLS, Basic, OAuth2)

Links

• GitHub
• Official reference