Oracle Cloud实例上Java gRPC应用仅监听IPv6地址求助

问题背景 #

在Oracle Cloud Linux实例上运行Java gRPC应用时，应用仅监听IPv6地址（:::16507），但相同代码部署在Windows上时，会同时监听IPv4（0.0.0.0:16507）和IPv6地址。已尝试设置grpc.address=0.0.0.0、切换gRPC Spring Boot Starter依赖（net.devh:grpc-server-spring-boot-starter → io.github.lognet:grpc-spring-boot-starter），但问题未解决。

服务器端监听状态（Linux） #

$ netstat -tulp | grep 16507
(Not all processes could be identified, non-owned process info
 will not be shown, you would have to be root to see it all.)
tcp6       0      0 [::]:16507              [::]:*                  LISTEN      210081/java
$ sudo netstat -tulpn | grep 16507
tcp6       0      0 :::16507                :::*                    LISTEN      210081/java

Windows端监听状态 #

> netstat -ano | findstr :16507
  TCP    0.0.0.0:16507          0.0.0.0:0              LISTENING       40124
  TCP    [::]:16507             [::]:0                 LISTENING       40124

解决方案 #

1. 调整Linux系统的IPv6绑定参数 #

Linux的net.ipv6.bindv6only参数如果设为1，会强制绑定IPv6的端口不接收IPv4请求，这是最常见的原因：

• 查看当前参数值：

  sysctl net.ipv6.bindv6only
  

• 若输出为net.ipv6.bindv6only = 1，临时修改为0：

  sudo sysctl -w net.ipv6.bindv6only=0
  

• 永久生效：编辑/etc/sysctl.conf，添加或修改该行：

  net.ipv6.bindv6only=0
  

  执行sudo sysctl -p加载新配置。

2. 强制Java优先使用IPv4 #

添加JVM启动参数，让Java应用优先绑定IPv4地址：

java -Djava.net.preferIPv4Stack=true -jar your-application.jar

如果是Spring Boot应用，也可以在application.properties中添加：

grpc.server.address=0.0.0.0
java.net.preferIPv4Stack=true

3. 显式配置gRPC绑定地址 #

使用gRPC原生API时，直接指定绑定IPv4的0.0.0.0地址：

Server server = ServerBuilder.forPort(16507)
    .addService(new YourGrpcServiceImpl())
    .bindAddress(InetAddress.getByName("0.0.0.0"))
    .build();

4. 检查Oracle Cloud网络配置 #

• 确认实例安全组已开放IPv4协议的16507端口，避免因防火墙规则导致误以为是监听问题；
• 检查实例是否被配置为仅使用IPv6，Oracle Cloud默认支持双栈，但自定义网络配置可能修改这一设置。

5. 验证Java版本兼容性 #

部分旧版Java对IPv6双栈的支持存在问题，尝试切换到Java 11或17等LTS版本，确认是否是版本导致的差异。

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