SpringBoot应用云端Redis连接正常，本地JUnit测试遇localhost未知主机异常求助

从你给出的异常栈来看，核心问题是java.net.UnknownHostException: localhost——这说明你的JUnit测试运行的JVM环境无法解析localhost这个主机名，哪怕你已经配置了hosts文件也没生效。结合你云环境连接正常的情况，问题应该出在本地测试环境的配置或运行条件上，下面是几个针对性的排查和解决思路：

1. 先确认本地Redis服务的状态和绑定配置 #

首先排除Redis本身的问题：

• 用redis-cli ping命令测试本地Redis是否正常运行，正常应该返回PONG；
• 检查Redis的绑定地址：打开redis.conf文件，找到bind配置项，确保它包含127.0.0.1（默认配置）或者设置为0.0.0.0（允许所有IP访问，测试环境可临时使用），修改后重启Redis服务；
• 检查端口占用：用netstat -ano | findstr :6379（Windows）或lsof -i :6379（Linux/Mac）确认6379端口确实被Redis进程占用。

2. 排查JUnit测试的JVM运行参数 #

有些JVM参数会影响主机名解析：

• 检查是否设置了-Djava.net.preferIPv6Addresses=true参数，这会让JVM优先使用IPv6解析localhost，但如果你的Redis没有监听IPv6地址（默认只监听IPv4的127.0.0.1），就会连接失败。可以在测试的JVM参数中添加-Djava.net.preferIPv4Stack=true强制使用IPv4；
• 检查是否禁用了DNS缓存或设置了异常的TTL：可以添加-sun.net.inetaddr.ttl=0参数禁用JVM的DNS缓存，避免旧的解析结果影响。

3. 检查测试代码的配置覆盖问题 #

有可能你的测试环境覆盖了Redis连接配置：

• 查看测试类是否使用了@TestPropertySource注解，或者是否存在application-test.properties/yaml配置文件，里面的Redis host配置是否和你代码中写的一致；
• 暂时简化连接工厂代码，去掉clientConfig参数，用默认构造方法测试：

LettuceConnectionFactory lettuceConnectionFactory = new LettuceConnectionFactory(redisStandaloneConfiguration);
lettuceConnectionFactory.setValidateConnection(true);

如果这样能连接成功，说明问题出在你自定义的clientConfig里——比如配置了特殊的DNS解析器、代理或者Socket选项，需要检查clientConfig的配置逻辑。

4. 排查本地网络和安全软件的拦截 #

本地防火墙或安全软件可能会阻止测试进程访问Redis端口：

• 暂时关闭Windows防火墙、Mac系统防火墙或杀毒软件，再运行测试看是否能连接；
• 如果关闭后正常，需要给Redis的6379端口添加允许访问的规则，或者允许测试进程（比如IDE的进程）访问网络。

5. 强制刷新JVM的Host解析缓存 #

有时候JVM会缓存hosts文件的解析结果，即使修改了hosts也不会立即生效：

• 重启你的IDE和Redis服务，让JVM重新加载hosts配置；
• 也可以在测试代码开头添加一段代码强制解析localhost，触发缓存更新：

try {
    InetAddress.getByName("localhost").getHostAddress();
} catch (UnknownHostException e) {
    e.printStackTrace();
}

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