Quarkus环境下gRPC客户端连接异常排查求助

1. 为什么GRPC_TRACE和GRPC_VERBOSITY环境变量未生效？ #

• Quarkus采用JBoss Logging作为日志框架，会接管gRPC原生的日志输出逻辑，导致gRPC官方文档中的GRPC_TRACE、GRPC_VERBOSITY环境变量无法直接生效，gRPC的日志会通过Quarkus的日志系统统一输出，而非原生日志工具。
• 环境变量未正确传递至应用进程：比如容器部署场景中未正确挂载变量，或者应用启动后才设置变量但未重启应用。
• GRPC_TRACE取值格式错误：该变量需要指定具体跟踪类别（如all、transport,channel），若填写无效值（如trace）则不会触发日志输出。

2. 如何获取更多连接被关闭的原因信息？ #

• 开启底层日志捕获
  在application.properties中添加以下配置，直接捕获gRPC及依赖Netty的底层交互日志：

  quarkus.log.category."io.grpc".level=TRACE
  quarkus.log.category."io.netty".level=DEBUG
  quarkus.log.category."io.grpc.netty".level=TRACE
  

  这些配置会输出连接建立、TLS握手、数据包传输等细节，帮助定位连接被强制关闭的时机和触发点。

• 自定义gRPC客户端拦截器
  实现ClientInterceptor监听连接关闭事件，打印详细状态元数据：

  public class GrpcClientLoggingInterceptor implements ClientInterceptor {
      private static final Logger LOG = Logger.getLogger(GrpcClientLoggingInterceptor.class);
  
      @Override
      public <ReqT, RespT> ClientCall<ReqT, RespT> interceptCall(MethodDescriptor<ReqT, RespT> method,
                                                                 CallOptions callOptions, Channel next) {
          ClientCall<ReqT, RespT> call = next.newCall(method, callOptions);
          return new ForwardingClientCall.SimpleForwardingClientCall<ReqT, RespT>(call) {
              @Override
              public void start(Listener<RespT> responseListener, Metadata headers) {
                  super.start(new ForwardingClientCallListener.SimpleForwardingClientCallListener<RespT>(responseListener) {
                      @Override
                      public void onClose(Status status, Metadata trailers) {
                          LOG.debugf("gRPC调用关闭，状态码：%s，描述：%s，异常原因：%s",
                                  status.getCode(), status.getDescription(), status.getCause());
                          if (trailers != null && !trailers.isEmpty()) {
                              LOG.debugf("服务端返回的Trailers元数据：%s", trailers);
                          }
                          super.onClose(status, trailers);
                      }
                  }, headers);
              }
          };
      }
  }
  

  注册拦截器（以客户端名为your-client-name为例）：

  quarkus.grpc.client."your-client-name".interceptors=com.your.package.GrpcClientLoggingInterceptor
  

• 对比grpcurl的配置细节
  执行grpcurl -v命令发起请求，查看TLS握手、连接超时等细节，对比Quarkus客户端的配置：

  • 检查TLS开关：quarkus.grpc.client."your-client-name".tls.enabled是否与服务端要求一致
  • 核对证书路径：若服务端使用自定义证书，客户端需配置quarkus.grpc.client."your-client-name".tls.trust-store

• 调整连接保活与超时参数
  确保Quarkus客户端的连接参数与grpcurl一致，示例配置：

  quarkus.grpc.client."your-client-name".connect-timeout=10s
  quarkus.grpc.client."your-client-name".keep-alive-time=30s
  quarkus.grpc.client."your-client-name".keep-alive-timeout=5s
  

内容的提问来源于stack exchange，提问作者Daniel Dani