GRPC Netty远程主机部署出现地址族不支持协议错误求助

将服务以fatjar形式部署至远程主机时，出现gRPC连接错误：

Wrapped by: io.grpc.netty.shaded.io.netty.channel.AbstractChannel$AnnotatedConnectException: connect(..) failed: Address family not supported by protocol: /somegrpcservice-grpc.abc.com:443
Wrapped by: io.grpc.StatusRuntimeException: UNAVAILABLE: io exception
    at io.grpc.stub.ClientCalls.toStatusRuntimeException(ClientCalls.java:271)
    at io.grpc.stub.ClientCalls.getUnchecked(ClientCalls.java:252)
    at io.grpc.stub.ClientCalls.blockingUnaryCall(ClientCalls.java:165)

本地运行正常，仅远程部署时触发该问题，已尝试以下方案无效：

• 更换io.grpc:grpc-netty-shaded版本（1.30.0至1.53.0）
• 远程主机通过Ncat成功连接目标服务
• 设置系统属性-Djava.net.preferIPv4Stack=true

1. 对比Java与系统的DNS解析结果
   系统工具（如Ncat）的DNS解析逻辑和Java可能存在差异。在远程主机上执行nslookup somegrpcservice-grpc.abc.com获取系统解析结果，再编写简单的Java类单独查询该域名的解析地址，对比两者是否一致——重点看是否返回了远程主机不支持的IPv6地址，或者解析出的IP存在异常。

2. 精准强制gRPC使用IPv4
   全局的preferIPv4Stack可能未覆盖gRPC的Netty通道配置，可直接给gRPC通道添加IPv4强制规则：

   ManagedChannel channel = NettyChannelBuilder.forTarget("somegrpcservice-grpc.abc.com:443")
       .defaultLoadBalancingPolicy("round_robin")
       .resolverFactory(new DnsNameResolverProvider() {
           @Override
           public NameResolver newNameResolver(URI targetUri, NameResolver.Args args) {
               return DnsNameResolverBuilder.forAddressResolverGroup(DefaultAddressResolverGroup.IPv4)
                   .channelFactory(args.channelFactory())
                   .eventLoop(args.eventLoop())
                   .build(targetUri.getHost());
           }
       })
       .build();
   

   也可通过启动参数直接禁用Netty的IPv6支持：-Dio.grpc.netty.shaded.io.netty.ipv6.disable=true

3. 排查fatjar的依赖冲突
   本地运行环境与fatjar的依赖可能不一致，执行jar tf your-fatjar.jar | grep netty查看包内Netty相关类，确认是否混入多版本Netty导致gRPC调用错误实现。可使用Maven Shade插件的relocate功能重新打包，隔离依赖：

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-shade-plugin</artifactId>
       <version>3.4.1</version>
       <executions>
           <execution>
               <phase>package</phase>
               <goals>
                   <goal>shade</goal>
               </goals>
               <configuration>
                   <relocations>
                       <relocation>
                           <pattern>io.netty</pattern>
                           <shadedPattern>your.package.shaded.io.netty</shadedPattern>
                       </relocation>
                   </relocations>
               </configuration>
           </execution>
       </executions>
   </plugin>
   

4. 检查远程主机网络细节

   • 查看/etc/hosts是否存在目标域名的异常映射，比如错误的IPv6地址；
   • 确认是否有针对Java进程的防火墙/SELinux策略限制，而非全局网络访问；
   • 对比本地与远程主机的Java版本，不同版本的网络实现可能存在差异。

5. 启用调试日志定位问题
   在远程主机启动服务时添加日志参数，获取连接过程的详细日志：

   -Dlogging.level.io.grpc=DEBUG -Dlogging.level.io.grpc.netty.shaded.io.netty=DEBUG
   

   从日志中可查看DNS解析结果、通道初始化步骤，精准定位是解析阶段还是连接阶段出现异常。

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