Spring Boot 3 升级后，@GrpcClient 字段注入为 null 是因自动配置类未被正确加载；需显式导入 grpc-spring-boot-starter 的全部 AutoConfiguration 类以兼容 Spring Boot 3 的新启动机制。
spring boot 3 升级后，`@grpcclient` 字段注入为 `null` 是因自动配置类未被正确加载；需显式导入 `grpc-spring-boot-starter` 的全部 autoconfiguration 类以兼容 spring boot 3 的新启动机制。
在 Spring Boot 3 中，spring-boot-starter 的自动配置加载机制发生了重要变更（如 spring.factories 被 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 取代），而 net.devh:grpc-client-spring-boot-starter（≤ v2.13.0）尚未完全适配该变更，导致其核心自动配置类（如 GrpcClientAutoConfiguration）未被启用，进而使 @GrpcClient 注解失效，字段保持 null。
✅ 正确解决方案：显式导入自动配置类
你需要创建一个空的 @Configuration 类，并通过 @ImportAutoConfiguration 显式声明所有必需的 gRPC 客户端自动配置类。这是目前最稳定、官方推荐的 Spring Boot 3 兼容方案（参考 issue #823）。
import org.springframework.boot.autoconfigure.ImportAutoConfiguration;
import org.springframework.context.annotation.Configuration;
@Configuration
@ImportAutoConfiguration({
// 客户端核心配置
net.devh.boot.grpc.client.autoconfigure.GrpcClientAutoConfiguration.class,
net.devh.boot.grpc.client.autoconfigure.GrpcClientMetricAutoConfiguration.class,
net.devh.boot.grpc.client.autoconfigure.GrpcClientHealthAutoConfiguration.class,
net.devh.boot.grpc.client.autoconfigure.GrpcClientSecurityAutoConfiguration.class,
net.devh.boot.grpc.client.autoconfigure.GrpcClientTraceAutoConfiguration.class,
net.devh.boot.grpc.client.autoconfigure.GrpcDiscoveryClientAutoConfiguration.class,
// 公共基础配置（必须）
net.devh.boot.grpc.common.autoconfigure.GrpcCommonCodecAutoConfiguration.class,
net.devh.boot.grpc.common.autoconfigure.GrpcCommonTraceAutoConfiguration.class,
// 【可选】服务端配置（仅当项目同时含 gRPC Server 时启用）
net.devh.boot.grpc.server.autoconfigure.GrpcAdviceAutoConfiguration.class,
net.devh.boot.grpc.server.autoconfigure.GrpcHealthServiceAutoConfiguration.class,
net.devh.boot.grpc.server.autoconfigure.GrpcReflectionServiceAutoConfiguration.class,
net.devh.boot.grpc.server.autoconfigure.GrpcServerAutoConfiguration.class,
net.devh.boot.grpc.server.autoconfigure.GrpcServerFactoryAutoConfiguration.class,
net.devh.boot.grpc.server.autoconfigure.GrpcServerMetricAutoConfiguration.class,
net.devh.boot.grpc.server.autoconfigure.GrpcServerSecurityAutoConfiguration.class,
net.devh.boot.grpc.server.autoconfigure.GrpcServerTraceAutoConfiguration.class
})
public class GrpcConfig {
// 空配置类，仅用于触发自动配置加载
}⚠️ 注意事项：
- 客户端项目只需保留前两组（client.* + common.*）；若你不提供 gRPC 服务端，请务必移除 server.* 相关配置项，避免无谓依赖和潜在 Bean 冲突。
- 确保 grpc-client-spring-boot-starter 版本 ≥ 2.13.0.RELEASE（推荐升级至 2.14.0.RELEASE 或更高版本，已初步支持 Spring Boot 3.1+）。
- application.yml 配置无需修改，保持原有结构即可：
grpc: client: handyman-client: address: static://localhost:8080 negotiationType: plaintext
✅ 验证是否生效
重启应用后，可通过以下方式验证：
- 检查日志中是否出现类似 GrpcClientAutoConfiguration matched 的 INFO 日志；
- 在 SystemService 中添加非空校验（开发阶段建议）：
@PostConstruct public void checkClient() { if (handymanClient == null) { throw new IllegalStateException("@GrpcClient injection failed — verify GrpcConfig is loaded"); } }
? 后续建议（长期）
- 升级到 grpc-spring-boot-starter v2.15.0+（已正式支持 Spring Boot 3.2+），届时可回归标准用法，无需手动 @ImportAutoConfiguration；
- 若使用 Spring Boot 3.2+，还可结合 @EnableGrpcClients（需确认 starter 版本支持）进一步简化配置。
通过上述配置，你的 @GrpcClient 将正常注入，彻底解决 Spring Boot 3 下 gRPC 客户端“空指针”问题，兼顾稳定性与可维护性。
