Spring Boot启动报Zipkin连接超时错误,未使用Zipkin服务如何解决
报错成因
- 项目引入了Spring Cloud Sleuth与Zipkin的集成依赖,默认触发
ZipkinAutoConfiguration自动装配机制,会自动将链路追踪数据上报到Zipkin服务 - Zipkin默认上报地址为
http://localhost:9411/api/v2/spans,你未部署启动Zipkin服务,因此上报请求触发连接超时异常,启动日志中与ZipkinAutoConfiguration相关的报错也验证了该逻辑。
解决方案
无需使用Zipkin链路追踪
可通过两种方式处理:
- 修改配置文件关闭自动上报
application.yml配置示例:
spring: zipkin: enabled: false # 若不需要链路追踪能力,可同时关闭Sleuth sleuth: enabled: false
application.properties配置示例:
spring.zipkin.enabled=false spring.sleuth.enabled=false
- 移除相关依赖
从pom.xml或build.gradle中删除spring-cloud-sleuth-zipkin相关的依赖项,即可关闭Zipkin自动装配逻辑,避免发起上报请求。
需要使用Zipkin链路追踪
- 下载对应版本的Zipkin服务jar包,本地执行
java -jar zipkin.jar启动服务,默认监听9411端口,Zipkin服务启动完成后再启动项目即可 - 若Zipkin部署在其他服务器,修改配置中的上报地址即可:
spring: zipkin: base-url: http://你的Zipkin服务部署IP:对应端口
内容的提问来源于stack exchange,提问作者Ksha
相关产品推荐
相关产品推荐

