Spring Eureka无法确定本地主机名，如何指定单个网络接口？

我尝试在本地部署Spring Eureka Server，但Eureka应用无法确定本地主机名，导致registered-replicas和unavailable-replicas的值为空。请问如何强制Spring应用选择一个指定的网络接口？

本地Eureka应用截图 #

pom文件片段 #

...
    <properties>
        <spring-cloud.version>2021.0.5</spring-cloud.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
        </dependency>
    </dependencies>
...

EurekaApplication.java代码 #

@SpringBootApplication
@EnableEurekaServer
public class EurekaApplication {

    public static void main(String[] args) {
        SpringApplication.run(EurekaApplication.class, args);
    }
}

application.properties配置 #

server.port=8761

eureka.client.register-with-eureka=false
eureka.client.fetch-registry=false
logging.level.com.netflix.eureka=OFF
logging.level.com.netflix.discovery=OFF
logging.level.org.springframework.cloud.commons.util.InetUtils= trace

控制台日志片段 #

2022-12-02 13:12:35.170  INFO 13588 --- [           main] c.s.j.s.i.a.WebApplicationImpl           : 初始化Jersey应用，版本 'Jersey: 1.19.4 05/24/2017 03:20 PM'
2022-12-02 13:12:35.828 TRACE 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 测试接口: Software Loopback Interface 1
2022-12-02 13:12:35.830 TRACE 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 测试接口: VirtualBox Host-Only Ethernet Adapter
2022-12-02 13:12:35.830 TRACE 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 发现非回环接口: VirtualBox Host-Only Ethernet Adapter
2022-12-02 13:12:35.836 TRACE 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 测试接口: Intel(R) Ethernet Connection (7) I219-V
2022-12-02 13:12:35.882 TRACE 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 测试接口: Hyper-V Virtual Ethernet Adapter
2022-12-02 13:12:35.893 TRACE 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 测试接口: Hyper-V Virtual Ethernet Adapter #2
2022-12-02 13:12:36.913  INFO 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 无法确定本地主机名
2022-12-02 13:12:37.429 TRACE 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 测试接口: Software Loopback Interface 1
2022-12-02 13:12:37.431 TRACE 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 测试接口: VirtualBox Host-Only Ethernet Adapter
2022-12-02 13:12:37.431 TRACE 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 发现非回环接口: VirtualBox Host-Only Ethernet Adapter
2022-12-02 13:12:37.437 TRACE 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 测试接口: Intel(R) Ethernet Connection (7) I219-V
2022-12-02 13:12:37.483 TRACE 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 测试接口: Hyper-V Virtual Ethernet Adapter
2022-12-02 13:12:37.494 TRACE 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 测试接口: Hyper-V Virtual Ethernet Adapter #2
2022-12-02 13:12:38.509  INFO 13588 --- [           main] o.s.cloud.commons.util.InetUtils         : 无法确定本地主机名
2022-12-02 13:12:38.751  INFO 13588 --- [           main] DiscoveryClientOptionalArgsConfiguration : Eureka HTTP Client 使用 Jersey
2022-12-02 13:12:38.806  WARN 13588 --- [           main] iguration$LoadBalancerCaffeineWarnLogger : Spring Cloud LoadBalancer 当前使用默认缓存。该缓存实现适用于开发和测试环境，生产环境建议使用Caffeine缓存。可通过添加Caffeine依赖和org.springframework.cache.caffeine.CaffeineCacheManager到类路径切换。
2022-12-02 13:12:38.826  INFO 13588 --- [           main] o.s.c.n.eureka.InstanceInfoFactory       : 设置初始实例状态为: STARTING
2022-12-02 13:12:38.968  INFO 13588 --- [           main] o.s.b.a.e.web.EndpointLinksResolver      : 在基础路径'/actuator'下暴露1个端点
2022-12-02 13:12:38.995  INFO 13588 --- [           main] o.s.c.n.e.s.EurekaServiceRegistry        : 向eureka注册应用UNKNOWN，状态为UP
2022-12-02 13:12:39.009  INFO 13588 --- [       Thread-9] o.s.c.n.e.server.EurekaServerBootstrap   : isAws返回false
2022-12-02 13:12:39.011  INFO 13588 --- [       Thread-9] o.s.c.n.e.server.EurekaServerBootstrap   : 初始化服务器上下文
2022-12-02 13:12:39.019  INFO 13588 --- [       Thread-9] e.s.EurekaServerInitializerConfiguration : Eureka Server已启动
2022-12-02 13:12:39.023  INFO 13588 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat已启动，端口为: 8761 (http)，上下文路径为空

本地网络接口截图 #

解决方案 #

1. 直接指定Eureka实例的主机名/IP #

在application.properties中添加以下配置，强制指定实例使用的主机名或IP：

# 方法A：指定主机名
eureka.instance.hostname=localhost

# 方法B：指定具体IP（替换为你目标网络接口的实际IP）
eureka.instance.ip-address=192.168.xxx.xxx
# 开启优先使用IP注册
eureka.instance.prefer-ip-address=true

如果要绑定到物理网卡，直接填写该网卡对应的IP即可，比如你本地的Intel(R) Ethernet Connection (7) I219-V的IP。

2. 配置Spring Cloud网络接口筛选规则 #

通过Spring Cloud的InetUtils配置，精准选择或排除网络接口：

方式A：只允许指定的网络接口

添加配置匹配目标接口的名称（支持正则表达式）：

# 匹配名称包含"Intel(R) Ethernet Connection (7) I219-V"的接口，正则可简化为Intel.*I219-V
spring.cloud.inetutils.preferred-networks=Intel.*I219-V

这样Spring会优先选择符合该规则的非回环接口。

方式B：排除虚拟接口

如果不想让Spring选择VirtualBox、Hyper-V这类虚拟网卡，直接排除它们：

# 排除名称包含VirtualBox或Hyper-V的接口
spring.cloud.inetutils.ignored-interfaces=VirtualBox.*,Hyper-V.*

排除后，Spring会自动从剩余的接口中选择合适的非回环接口。

3. 启动时通过JVM参数指定 #

临时测试或通过启动脚本配置时，可添加JVM参数直接指定主机名/IP：

# 指定主机名
java -jar your-eureka-app.jar -Dspring.cloud.client.hostname=localhost

# 或者指定IP
java -jar your-eureka-app.jar -Dspring.cloud.client.ip-address=192.168.xxx.xxx

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