localhost解析为IPv6导致R2DBC间歇性连接拒绝的原因咨询

为何未开启IPv4优先配置时，R2DBC场景会随机出现部分测试失败 #

• JVM在未设置java.net.preferIPv4Stack=true参数时，本地对localhost域名的解析结果会同时包含两类回环地址：IPv4格式的127.0.0.1、IPv6格式的::1（即调试时看到的0:0:0:0:0:0:0:1），且两次解析返回的地址顺序没有固定规则，受运行时DNS缓存状态、系统hosts映射优先级的影响存在随机性。
• 结合排查得到的netstat结果可以确认，Testcontainer映射数据库端口时，仅在IPv4网卡的0.0.0.0地址上开启了端口监听，IPv6回环地址::1上根本没有对应端口的流量入口，直接向这个地址发起连接必然会被拒绝。
• r2dbc-postgresql客户端默认的连接逻辑，是直接取DNS解析返回结果列表中的第一个地址发起连接，不会自动回退尝试列表内的其他地址。这就导致每次测试发起R2DBC连接时，只要解析返回的第一个地址是无效的IPv6回环地址，连接就会直接失败；如果第一个返回的是有效的IPv4回环地址，连接就能正常建立。这种完全随机的地址优先级，就是3个测试用例没有固定失败规律、每次构建随机有不同数量的测试挂掉的根本原因。

为何同场景下JDBC连接不会出现同类问题 #

• PostgreSQL JDBC驱动的连接逻辑，会对DNS解析返回的所有地址列表做全量遍历尝试：只要列表内有能连通的地址，就会自动切换到可连通的地址完成连接，不会因为第一个地址连接失败就直接抛出错误。
• 就算某次localhost解析返回的第一个地址是无效的IPv6回环地址，JDBC驱动尝试连接失败后，会自动切到列表内的IPv4有效地址继续连接，最终必然能匹配到Testcontainer已经做好端口映射的IPv4监听端口，从机制上兜住了解析顺序随机带来的IPv6地址干扰，因此不会出现连接被拒的问题。这也是之前用JDBC跑Liquibase做数据库初始化时，从来没有碰到过同类异常的原因。

现有解决方案的生效原理 #

你目前使用的如下配置：

task integrationTest(type: Test) {
    // ...
    systemProperties = ['java.net.preferIPv4Stack': true] as Map<String, Object>
}

生效逻辑非常直接：给集成测试的JVM进程加上优先使用IPv4栈的参数后，JVM会直接禁用IPv6网络栈，解析localhost时只会返回IPv4格式的回环地址，从根源上避免了无效IPv6地址出现在R2DBC客户端的解析结果里，因此问题会直接消失。

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