集成GRPC服务器后启动报错：缺失GrpcAuthenticationReader Bean

在Spring Boot应用中集成gRPC服务器后，启动时触发如下错误，无详细日志，相关参考信息较少：

Description:

Parameter 1 of method authenticatingServerInterceptor in net.devh.boot.grpc.server.autoconfigure.GrpcServerSecurityAutoConfiguration required a bean of type 'net.devh.boot.grpc.server.security.authentication.GrpcAuthenticationReader' that could not be found.

Action:

Consider defining a bean of type 'net.devh.boot.grpc.server.security.authentication.GrpcAuthenticationReader' in your configuration.

解决方法 #

这个错误是因为项目引入了gRPC服务端安全相关的自动配置依赖，但未配置对应的认证读取器Bean，可通过以下两种方式解决：

方式一：配置GrpcAuthenticationReader实现类 #

如果需要启用gRPC服务端的安全认证，需自定义注册一个GrpcAuthenticationReader的Bean。可以直接使用框架提供的现成实现（比如BasicAuthenticationReader、BearerAuthenticationReader），也可以自定义逻辑：

import net.devh.boot.grpc.server.security.authentication.BearerAuthenticationReader;
import net.devh.boot.grpc.server.security.authentication.GrpcAuthenticationReader;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class GrpcSecurityConfig {

    @Bean
    public GrpcAuthenticationReader grpcAuthenticationReader() {
        // 示例：使用Bearer令牌认证读取器
        return new BearerAuthenticationReader();
    }
}

注意：使用框架提供的实现时，需确保grpc-server-spring-boot-starter-security相关依赖已正确引入。

方式二：排除gRPC安全自动配置类 #

如果不需要gRPC服务端的安全认证功能，直接在Spring Boot启动类上排除GrpcServerSecurityAutoConfiguration即可避免触发自动配置逻辑：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import net.devh.boot.grpc.server.autoconfigure.GrpcServerSecurityAutoConfiguration;

@SpringBootApplication(exclude = {GrpcServerSecurityAutoConfiguration.class})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

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