在Java中如何搭建微服务开发环境_Spring Cloud环境准备说明

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 2025.x（即 2025.0.4 等），对应 spring-cloud-dependencies BOM 坐标中的 2025.0.x
• Spring Boot 2.7.x 最高支持 Spring Cloud 2025.0.x（2025.0.8），不能再用 Hoxton 或 2025.x
• Maven 中必须用 spring-cloud-dependencies BOM 控制子模块版本，不能单独写 version —— 否则 spring-cloud-starter-config 和 spring-cloud-starter-openfeign 会因内部依赖不一致而冲突

  
    
      org.springframework.cloud
      spring-cloud-dependencies
      2025.0.4
      pom
      import
    
  

选对注册中心：Eureka 已停更，推荐使用 Alibaba Nacos 或 Spring Cloud Consul

Eureka 2.x 自 2018 年起已停止维护，Spring Cloud Netflix 项目在 2025 年归档，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，没有任何明确报错。

• 必须在 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

Fe

ign 调用 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 注解有用得多。