服务注册与分布式协调 / 系统课时
为应用接入服务发现依赖
为应用接入服务发现依赖
这一课只解决“让现有 Spring Boot 应用具备向 Nacos 注册的能力”:接入 Discovery Starter,配置稳定的服务名与 Nacos 地址,并在启动前确认依赖已经进入运行时类路径。
学习目标
- 为 Spring Boot 应用接入 Nacos Discovery Starter,并避免依赖版本各自硬编码
- 配置
spring.application.name、应用端口与server-addr - 在真正启动注册前,用 Maven 验证服务发现依赖已经生效
先确定依赖基线
Spring Cloud Alibaba 与 Spring Boot、Spring Cloud 需要按兼容版本线组合使用。已有项目应优先沿用项目统一的 BOM,不要只给 spring-cloud-starter-alibaba-nacos-discovery 单独指定一个“看起来最新”的版本,否则容易出现类缺失或自动配置不兼容。
下面以已经采用 Spring Cloud Alibaba BOM 的 Maven 项目为例。片段示例放在 pom.xml 的 <dependencies> 中:
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>如果项目还没有 Spring Cloud Alibaba BOM,应先根据当前 Spring Boot 与 Spring Cloud 版本选择对应的 BOM,再引入 Starter。依赖管理完成后,Starter 会把服务注册、服务发现以及与 Spring Cloud DiscoveryClient 的集成带入应用。
配置服务名与 Nacos 地址
服务名来自 spring.application.name,它是消费者后续按名称发现实例时使用的稳定标识;server.port 则属于当前实例。Nacos 连接地址不要写成控制台页面地址,而应填写 Nacos 客户端能够访问的服务端地址。
片段示例,保存到 src/main/resources/application.yml:
server:
port: 8081
spring:
application:
name: inventory-service
cloud:
nacos:
discovery:
server-addr: ${NACOS_SERVER_ADDR:127.0.0.1:8848}这里把 Nacos 地址交给环境变量 NACOS_SERVER_ADDR 覆盖,本地未设置时才回退到 127.0.0.1:8848。这样同一份构建产物可以在开发、测试和生产环境连接不同的注册中心,而不需要修改包内配置。
验证依赖已经进入项目
在项目根目录执行依赖树查询:
mvn dependency:tree -Dincludes=com.alibaba.cloud:spring-cloud-starter-alibaba-nacos-discovery预期输出:
[INFO] com.example:<ARTIFACT>:jar:<VERSION>
[INFO] +- com.alibaba.cloud:spring-cloud-starter-alibaba-nacos-discovery:jar:<VERSION>:compile
[INFO] BUILD SUCCESS<ARTIFACT> 与 <VERSION> 会随项目实际配置变化。出现 Starter 且构建成功,说明依赖解析已经完成;这一步只验证“依赖可用”,不会证明应用已经成功连接 Nacos。
接入失败时先看这三处
如果依赖树里完全没有 Starter,先检查它是否被放在了错误的 Maven Profile,或者是否被父 POM 的依赖排除规则移除。如果启动时报 ClassNotFoundException、NoSuchMethodError 一类错误,应优先核对 Spring Boot、Spring Cloud 与 Spring Cloud Alibaba 的版本线,而不是继续修改 Nacos 地址。
如果依赖正常但后续注册失败,再检查 server-addr 是否能从应用运行环境访问,以及环境变量是否覆盖了本地默认值。容器中的 127.0.0.1 指向容器自身,不等于宿主机或另一个 Nacos 容器,这也是本地 Docker 环境最常见的连接误判之一。