java微服务开发需严格匹配spring boot与spring cloud版本，使用bom管理依赖，弃用eureka改用nacos/consul，启用bootstrap.yml，确保feign服务名大小写一致。
Java 微服务开发不是装几个依赖就能跑起来的，Spring Cloud 版本和 Spring Boot 版本强绑定，配错一对就卡在 ClassNotFoundException 或 Failed to load ApplicationContext —— 这是绝大多数人第一天就栽跟头的地方。
确认 Spring Boot 与 Spring Cloud 的版本兼容性
Spring Cloud 不是一个独立运行的框架，它是一套“依赖协调规范”，所有模块（如 spring-cloud-starter-netflix-eureka-client）都必须和当前 Spring Boot 版本对齐。官方只维护特定组合，硬凑高版本会直接编译失败或启动报 NoClassDefFoundError。
- Spring Boot 3.x（JDK 17+）只能用 Spring Cloud 2022.x（即
2022.0.4等），对应spring-cloud-dependenciesBOM 坐标中的2022.0.x - Spring Boot 2.7.x 最高支持 Spring Cloud 2021.0.x（
2021.0.8），不能再用Hoxton或2022.x - Maven 中必须用
spring-cloud-dependenciesBOM 控制子模块版本，不能单独写version—— 否则spring-cloud-starter-config和spring-cloud-starter-openfeign会因内部依赖不一致而冲突
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>2022.0.4</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
选对注册中心：Eureka 已停更，推荐使用 Alibaba Nacos 或 Spring Cloud Consul
Eureka 2.x 自 2018 年起已停止维护，Spring Cloud Netflix 项目在 2020 年归档，spring-cloud-starter-netflix-eureka-server 在 Spring Boot 3+ 中彻底不可用。继续沿用只会遇到 Artifact not found 或启动后服务无法注册。
- Nacos（推荐）：同时支持服务发现 + 配置中心，
nacos-server下载即用，Java 客户端适配 Spring Boot 3，Maven 引入spring-cloud-starter-alibaba-nacos-discovery - Consul：适合已有 HashiCorp 生态的团队，
spring-cloud-starter-consul-discovery对 JDK 17 兼容良好，但需额外部署 Consul Agent - 别碰
spring-cloud-starter-zookeeper-discovery：ZooKeeper 原生客户端对 Spring Boot 3 的响应式支持不完整，容易触发ConnectionLossException
配置中心启动失败？检查 bootstrap.yml 是否被忽略
Spring Boot 2.4+ 默认禁用 bootstrap.yml，而 Spring Cloud Config/Nacos 配置中心依赖它加载 spring.application.name 和 spring.cloud.nacos.config.server-addr。没启用就会连不上配置中心，日志里只显示 Could not locate PropertySource，没有任何明确报错。
立即学习“Java免费学习笔记（深入）”；
- 必须在
pom.xml中显式引入spring-cloud-starter-bootstrap（注意不是spring-cloud-context） -
bootstrap.yml必须放在src/main/resources/根目录，不能放在 profile 子目录下 - 如果用了
spring.profiles.active=dev，配置中心地址必须写在bootstrap-dev.yml，否则仍会 fallback 到默认值
spring:
application:
name: user-service
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
config:
server-addr: 127.0.0.1:8848
file-extension: yaml
Feign 调用 404？先验证服务名是否注册成功且大小写一致
Feign 接口定义里写的 @FeignClient("order-service")，实际注册到 Nacos 的服务名却是 ORDER-SERVICE 或 order_service，就会导致 Load balancer does not have available server for client。Spring Cloud 默认把服务名转成小写并用中划线分隔，但 Nacos 控制台显示的是原始注册名，极易看走眼。
- 访问
http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=order-service直接查注册结果，确认返回 JSON 中hosts数组非空 - Feign 接口上加
configuration = FeignConfig.class，并在FeignConfig里开启日志：Logger.Level.FULL，能看清真实请求 URL 和响应状态码 - 不要在
@FeignClient上写url = "http://localhost:8081"测试通不通——这绕过了服务发现，掩盖了注册问题
真正卡住人的往往不是代码写错，而是版本锁死、配置加载顺序、服务名大小写这些“看不见的约束”。多花五分钟查 Nacos 控制台的服务列表，比反复改 @FeignClient 注解有用得多。
