Spring Boot 3.x.x Admin Server异常：服务注册失败（域名解析错误）

核心问题分析 #

这个异常的根源是Admin Server无法解析Shruti.mshome.net域名，大概率是服务实例注册时上报了该主机名，但当前网络环境下无法通过DNS或本地映射找到对应IP。以下是针对性排查和解决步骤：

1. 定位域名来源 #

• 先确认Shruti.mshome.net的由来：
  • 执行系统命令查看主机名：Windows用hostname，Linux/macOS用hostnamectl，若主机名是Shruti，mshome.net是Windows默认域后缀，说明服务注册时自动使用了完整主机名。
  • 检查服务配置中是否硬编码该域名，比如spring.cloud.client.hostname或spring.boot.admin.client.instance.service-url这类配置项。

2. 强制服务使用IP注册（最直接方案） #

修改被注册服务的YAML配置，强制客户端以IP地址而非主机名上报给Admin Server：

spring:
  cloud:
    client:
      prefer-ip-address: true
      ip-address: ${你的服务实际IP} # 例如192.168.1.100，留空可让系统自动获取
  boot:
    admin:
      client:
        url: http://admin-server的IP或可解析域名:端口
        instance:
          prefer-ip: true # 关键配置，让客户端用IP注册

3. 本地hosts文件添加映射 #

若必须使用该主机名，可在Admin Server和服务所在机器的hosts文件中手动添加IP映射：

• Windows路径：C:\Windows\System32\drivers\etc\hosts
• Linux/macOS路径：/etc/hosts
  添加一行：

127.0.0.1   Shruti.mshome.net # 服务在本地时用此配置，否则替换为服务实际IP

4. 排查网络与DNS配置 #

• 在Admin Server所在机器执行ping Shruti.mshome.net，确认是否能解析到IP。如果不通：
  • 检查本地DNS服务器配置，尝试切换为公共DNS（如8.8.8.8）测试。
  • 确认防火墙未拦截DNS请求或服务间的网络连通性。

5. 校验版本兼容性 #

确保Spring Boot Admin Server和客户端的版本与Spring Boot 3.x完全匹配，比如Spring Boot Admin 3.2.x对应Spring Boot 3.2.x，版本不匹配可能导致注册逻辑异常。

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