Java NIO实现类似BSD IPV6_ONLY的IPv4/IPv6套接字行为控制

需求背景 #

开发基于Java NIO通道的跨平台项目，需实现类似BSD系统IPV6_ONLY标志的功能，控制IPv4和IPv6套接字绑定同一端口时的行为，具体需求：

• 在同一端口分别创建独立的IPv4和IPv6套接字（支持DatagramChannel、ServerSocketChannel、SocketChannel）；
• 配置IPv6套接字双模式：单个IPv6套接字可同时接收IPv4/IPv6数据包，或切换为仅接收IPv6数据包，模拟BSD的IPV6_ONLY标志行为。

当前代码与问题 #

现有简化代码：

// 打开IPv4 DatagramChannel
DatagramChannel ipv4Channel = DatagramChannel.open(StandardProtocolFamily.INET);
ipv4Channel.bind(new InetSocketAddress(port));

// 打开IPv6 DatagramChannel
DatagramChannel ipv6Channel = DatagramChannel.open(StandardProtocolFamily.INET6);
ipv6Channel.bind(new InetSocketAddress(port));

运行时触发port already in use错误，无法在同一端口绑定不同协议族的第二个套接字。

解决方案 #

1. 同一端口绑定独立IPv4和IPv6套接字 #

需为两个套接字同时设置SO_REUSEADDR和SO_REUSEPORT选项，结合显式绑定对应协议族地址，保证跨平台兼容性：

DatagramChannel示例

int port = 8080;

// 配置IPv4通道
DatagramChannel ipv4Channel = DatagramChannel.open(StandardProtocolFamily.INET);
ipv4Channel.setOption(StandardSocketOptions.SO_REUSEADDR, true);
ipv4Channel.setOption(StandardSocketOptions.SO_REUSEPORT, true);
ipv4Channel.bind(new InetSocketAddress(Inet4Address.getByName("0.0.0.0"), port));

// 配置IPv6通道
DatagramChannel ipv6Channel = DatagramChannel.open(StandardProtocolFamily.INET6);
ipv6Channel.setOption(StandardSocketOptions.SO_REUSEADDR, true);
ipv6Channel.setOption(StandardSocketOptions.SO_REUSEPORT, true);
// 开启IPV6_ONLY避免抢占IPv4端口
ipv6Channel.setOption(StandardSocketOptions.IPV6_ONLY, true);
ipv6Channel.bind(new InetSocketAddress(Inet6Address.getByName("::"), port));

ServerSocketChannel示例

int port = 8080;

// IPv4 ServerSocketChannel
ServerSocketChannel ipv4Server = ServerSocketChannel.open(StandardProtocolFamily.INET);
ipv4Server.setOption(StandardSocketOptions.SO_REUSEADDR, true);
ipv4Server.setOption(StandardSocketOptions.SO_REUSEPORT, true);
ipv4Server.bind(new InetSocketAddress("0.0.0.0", port));

// IPv6 ServerSocketChannel
ServerSocketChannel ipv6Server = ServerSocketChannel.open(StandardProtocolFamily.INET6);
ipv6Server.setOption(StandardSocketOptions.SO_REUSEADDR, true);
ipv6Server.setOption(StandardSocketOptions.SO_REUSEPORT, true);
ipv6Server.setOption(StandardSocketOptions.IPV6_ONLY, true);
ipv6Server.bind(new InetSocketAddress("::", port));

跨平台注意：

• Linux/macOS：SO_REUSEPORT允许多套接字绑定同一端口，SO_REUSEADDR辅助兼容；
• Windows：SO_REUSEADDR已包含类似SO_REUSEPORT的功能，同时设置两个选项保证兼容性；
• 必须显式绑定到对应协议族地址（0.0.0.0对应IPv4，::对应IPv6），且IPv6套接字需开启IPV6_ONLY=true，避免系统默认让IPv6套接字接收IPv4流量导致端口冲突。

2. 配置IPv6套接字双模式（模拟IPV6_ONLY） #

Java NIO提供标准StandardSocketOptions.IPV6_ONLY选项，直接控制IPv6套接字的接收模式：

DatagramChannel ipv6Channel = DatagramChannel.open(StandardProtocolFamily.INET6);
ipv6Channel.bind(new InetSocketAddress("::", port));

// 模式1：仅接收IPv6数据包（对应BSD的IPV6_ONLY=1）
ipv6Channel.setOption(StandardSocketOptions.IPV6_ONLY, true);

// 模式2：同时接收IPv4和IPv6数据包（对应BSD的IPV6_ONLY=0）
ipv6Channel.setOption(StandardSocketOptions.IPV6_ONLY, false);

跨平台注意：

• 该选项在Java 7及以上版本支持，兼容Linux、macOS、Windows；
• 设置IPV6_ONLY=false时，IPv4数据包会被映射为::ffff:0:0/96前缀的IPv6地址，由IPv6套接字接收；
• 若需同时使用独立的IPv4和IPv6套接字，必须将IPv6套接字的IPV6_ONLY设为true，否则IPv6套接字会占用端口导致IPv4套接字无法绑定。

内容的提问来源于Stack Exchange，提问作者Harshal Goyal