SpringBoot应用因InetAddress.getLocalHost()导致线程锁死排查与解决

核心原因 #

• DNS解析阻塞：InetAddress.getLocalHost()会触发本地主机名到IP的反向解析，若系统hosts文件未正确映射本地主机名（比如localhost未指向127.0.0.1），或DNS服务无响应/超时，这个同步调用会一直阻塞，且无内置超时机制。
• 高并发下线程池耗尽：日志过滤器是请求入口，每个请求都会执行该方法，大量并发请求进来时，所有工作线程都会卡在这个阻塞调用上，直接耗尽Tomcat线程池，表现为应用“锁死”。
• 底层锁竞争放大问题：该方法内部会用到全局缓存锁，高并发场景下多个线程同时调用会加剧锁竞争，进一步延长阻塞时间，甚至引发死锁。

解决方法 #

1. 提前初始化并缓存结果 #

在应用启动时一次性获取本地IP并缓存，避免请求链路中重复调用：

private static String localHostAddress;

@PostConstruct
public void initLocalHostAddress() {
    try {
        localHostAddress = InetAddress.getLocalHost().getHostAddress();
    } catch (UnknownHostException e) {
        localHostAddress = "127.0.0.1";
        log.error("Failed to fetch local host address, fallback to default", e);
    }
}

private void populateMandatoryDetailsFromRequest(final HttpServletRequest httpServletRequest) {
    ThreadContext.put(CO_HOST_ADDRESS.value(), localHostAddress);
    ThreadContext.put(CO_REQUEST_URI.value(), httpServletRequest.getRequestURI());
}

2. 修正系统hosts配置 #

确保本地主机名在hosts文件中有正确映射，避免依赖外部DNS：

• Linux：编辑/etc/hosts，添加：

  127.0.0.1   localhost
  ::1         localhost
  127.0.0.1   [你的主机名]
  

• Windows：编辑C:\Windows\System32\drivers\etc\hosts，添加上述内容。

3. 直接从网卡获取本地IP #

绕过DNS解析，从网络接口直接读取IP，避免主机名解析依赖：

private static String getLocalHostAddress() {
    try {
        Enumeration<NetworkInterface> interfaces = NetworkInterface.getNetworkInterfaces();
        while (interfaces.hasMoreElements()) {
            NetworkInterface ni = interfaces.nextElement();
            if (ni.isLoopback() || ni.isVirtual() || !ni.isUp()) {
                continue;
            }
            Enumeration<InetAddress> addresses = ni.getInetAddresses();
            while (addresses.hasMoreElements()) {
                InetAddress addr = addresses.nextElement();
                if (addr instanceof Inet4Address) {
                    return addr.getHostAddress();
                }
            }
        }
    } catch (SocketException e) {
        log.error("Failed to get IP from network interfaces", e);
    }
    return "127.0.0.1";
}

4. 添加超时控制（仅当必须动态获取时） #

将解析操作放到带超时的异步线程中，避免无限阻塞：

private String getLocalHostAddressWithTimeout() {
    ExecutorService executor = Executors.newSingleThreadExecutor();
    Future<String> future = executor.submit(() -> {
        try {
            return InetAddress.getLocalHost().getHostAddress();
        } catch (UnknownHostException e) {
            return "127.0.0.1";
        }
    });
    try {
        return future.get(1, TimeUnit.SECONDS);
    } catch (Exception e) {
        log.error("Local host address fetch timed out", e);
        future.cancel(true);
        return "127.0.0.1";
    } finally {
        executor.shutdown();
    }
}

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