SpringCloud+Ribbon 报错：java.net.unknownhostexception:XXX

最新推荐文章于 2025-05-29 20:07:47 发布

长而不宰

最新推荐文章于 2025-05-29 20:07:47 发布

阅读量1.4k

点赞数

CC 4.0 BY-SA版权

文章标签： spring cloud java ribbon

本文链接：https://blog.csdn.net/weixin_44892327/article/details/128750207

文章讲述了在SpringCloud使用Ribbon时遇到的UnknownHostException问题，分析了问题并非由依赖冲突引起，而是由于Eureka服务注册时使用了非本机IP的hostname。解决方案是设置`eureka.instance.preferIpAddress=true`或指定`eureka.instance.hostname`为本机IP，确保Eureka使用正确的IP进行服务注册。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

SpringCloud+Ribbon 报错：java.net.unknownhostexception:XXX
问题分析：
网上很多的说法是依赖冲突导致，原因是什么呢：如果你的org.springframework.cloud:spring-cloud-starter-netflix-eureka-client 依赖中包含了ribbon依赖，你还在pom里面添加Ribbon依赖就会出现错误。如：
在这里插入图片描述
但是我的问题，不是这个引起的。
我的报错显示unknownhostexception，显然是eureka的注册出了问题，但是我的注册信息在eureka的可视化界面又显示服务存在，随后我在网上找到这样一个配置

eureka.instance.preferIpAddress=true

随后我搜索了这个配置是什么意思，原来默认情况下，Eureka 使用 hostname 进行服务注册，以及服务信息的显示。
而我的hostname写的不是我本机的地址（也就是项目中provider中的地址）这也就导致了我错误的发生unknownhostexception。那么这个配置到底是干嘛的呢
配置eureka.instance.prefer-ip-address = true 就可以将IP注册到Eureka Server上，而如果不配置就是机器的主机名
我没有配置这个ip-address所以eureka默认使用的就是我的hostname。所以解决办法就有两个
一个就是在服务提供者的配置文件上配置好eureka.instance.preferIpAddress=true