Eureka Discovery Client注册异常求助：主机名解析失败

问题详情 #

使用Eureka Discovery Server搭建微服务时，API-GATEWAY的DiscoveryClient注册地址从DiscoveryClient_API-GATEWAY/host.docker.internal:api-gateway变为DiscoveryClient_API-GATEWAY/SL-GGnanaseelan.mshome.net:api-gateway，出现主机名解析失败错误：

java.net.UnknownHostException: Failed to resolve 'SL-GGnanaseelan.mshome.net' [A(1)] after 2 queries 
    at io.netty.resolver.dns.DnsResolveContext.finishResolve(DnsResolveContext.java:1125) ~[netty-resolver-dns-4.1.107.Final.jar:4.1.107.Final]
    Suppressed: reactor.core.publisher.FluxOnAssembly$OnAssemblyException: 
Error has been observed at the following site(s):

注册日志如下：

2024-03-28T16:24:19.884+05:30  INFO 20080 --- [api-gateway] [           main] com.netflix.discovery.DiscoveryClient    : Discovery Client initialized at timestamp 1711623259882 with initial instances count: 0
2024-03-28T16:24:19.886+05:30  INFO 20080 --- [api-gateway] [           main] o.s.c.n.e.s.EurekaServiceRegistry        : Registering application API-GATEWAY with eureka with status UP
2024-03-28T16:24:19.887+05:30  INFO 20080 --- [api-gateway] [           main] com.netflix.discovery.DiscoveryClient    : Saw local status change event StatusChangeEvent [timestamp=1711623259887, current=UP, previous=STARTING]
2024-03-28T16:24:19.889+05:30  INFO 20080 --- [api-gateway] [nfoReplicator-0] com.netflix.discovery.DiscoveryClient    : DiscoveryClient_API-GATEWAY/SL-GGnanaseelan.mshome.net:api-gateway: registering service...
2024-03-28T16:24:19.970+05:30  INFO 20080 --- [api-gateway] [nfoReplicator-0] com.netflix.discovery.DiscoveryClient    : DiscoveryClient_API-GATEWAY/SL-GGnanaseelan.mshome.net:api-gateway - registration status: 204

原因分析 #

Eureka客户端默认自动检测本地主机名完成注册，当网络环境变更（如Docker网络配置调整、Windows WSL域名解析干扰）时，会自动切换到无法被集群内其他服务解析的mshome.net域名。

解决方案 #

1. 强制固定注册主机名 #

在API-GATEWAY的配置文件中添加以下配置，强制使用host.docker.internal作为注册主机名：

application.yml

eureka:
  instance:
    hostname: host.docker.internal

application.properties

eureka.instance.hostname=host.docker.internal

2. 改用IP地址注册 #

如果主机名解析问题无法快速解决，可直接配置使用IP地址注册，避免域名解析依赖：

application.yml

eureka:
  instance:
    prefer-ip-address: true
    ip-address: 你的容器/主机实际IP

application.properties

eureka.instance.prefer-ip-address=true
eureka.instance.ip-address=你的容器/主机实际IP

3. 检查Docker网络配置 #

若服务运行在Docker容器中：

• 重启Docker服务刷新网络配置
• 验证容器网络模式（如host模式或自定义桥接网络）是否正确
• 在容器内执行ping host.docker.internal，确认该域名能正常解析

4. 修正本地DNS解析（Windows环境） #

mshome.net是Windows WSL的默认域名，若无需WSL服务，可通过以下方式修复：

• 编辑C:\Windows\System32\drivers\etc\hosts文件，添加映射：

  你的主机IP SL-GGnanaseelan.mshome.net
  

• 或禁用WSL的自动域名解析功能

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