Spring Cloud微服务实战：服务注册、网关、负载均衡全家桶指南

前言

Spring Cloud是Java微服务开发的事实标准，但很多开发者对它的核心组件还是一知半解。本文从零搭建一个完整的微服务项目，涵盖服务注册（Nacos）、网关（Spring Cloud Gateway）、负载均衡（LoadBalancer）三大核心组件。
一、项目架构

1. microservice-demo/
2. ├── service-gateway/        # API网关 (8080)
3. ├── service-user/           # 用户服务 (8081)
4. ├── service-order/          # 订单服务 (8082)
5. └── pom.xml                 # 父POM

复制代码

二、依赖版本管理

1. <properties>
2.     <java.version>17</java.version>
3.     <spring-boot.version>3.2.0</spring-boot.version>
4.     <spring-cloud.version>2023.0.0</spring-cloud.version>
5.     <spring-cloud-alibaba.version>2023.0.0.0</spring-cloud-alibaba.version>
6. </properties>
8. <dependencyManagement>
9.     <dependencies>
10.         <dependency>
11.             <groupId>org.springframework.cloud</groupId>
12.             spring-cloud-dependencies</artifactId>
13.             <version>${spring-cloud.version}</version>
14.             <type>pom</type>
15.             <scope>import</scope>
16.         </dependency>
17.         <dependency>
18.             <groupId>com.alibaba.cloud</groupId>
19.             spring-cloud-alibaba-dependencies</artifactId>
20.             <version>${spring-cloud-alibaba.version}</version>
21.             <type>pom</type>
22.             <scope>import</scope>
23.         </dependency>
24.     </dependencies>
25. </dependencyManagement>

复制代码

三、服务注册中心 - Nacos

1. 下载安装Nacos

1. # 下载Nacos
2. wget https://github.com/alibaba/nacos/releases/download/2.3.0/nacos-server-2.3.0.zip
3. unzip nacos-server-2.3.0.zip
4. cd nacos/bin
5. # 单机启动
6. ./startup.sh -m standalone

复制代码

2. 服务注册配置

1. # application.yml (用户服务)
2. spring:
3.   application:
4.     name: service-user
5.   cloud:
6.     nacos:
7.       discovery:
8.         server-addr: localhost:8848
9.         namespace: dev
11. server:
12.   port: 8081

复制代码

3. 启动类

1. @SpringBootApplication
2. @EnableDiscoveryClient
3. public class UserServiceApplication {
4.     public static void main(String[] args) {
5.         SpringApplication.run(UserServiceApplication.class, args);
6.     }
7. }

复制代码

四、API网关 - Spring Cloud Gateway

1. 添加依赖

1. <dependency>
2.     <groupId>org.springframework.cloud</groupId>
3.     spring-cloud-starter-gateway</artifactId>
4. </dependency>
5. <dependency>
6.     <groupId>com.alibaba.cloud</groupId>
7.     spring-cloud-starter-alibaba-nacos-discovery</artifactId>
8. </dependency>
9. <dependency>
10.     <groupId>org.springframework.cloud</groupId>
11.     spring-cloud-starter-loadbalancer</artifactId>
12. </dependency>

复制代码

2. 网关路由配置

1. spring:
2.   application:
3.     name: service-gateway
4.   cloud:
5.     nacos:
6.       discovery:
7.         server-addr: localhost:8848
8.     gateway:
9.       routes:
10.         - id: user-service
11.           uri: lb://service-user    # lb表示负载均衡
12.           predicates:
13.             - Path=/api/user/**
14.           filters:
15.             - StripPrefix=1        # 去掉/api前缀
16.         - id: order-service
17.           uri: lb://service-order
18.           predicates:
19.             - Path=/api/order/**
20.           filters:
21.             - StripPrefix=1
22.       # 跨域配置
23.       globalcors:
24.         cors-configurations:
25.           '[/**]':
26.             allowedOrigins: "*"
27.             allowedMethods: "*"
28.             allowedHeaders: "*"
30. server:
31.   port: 8080

复制代码

五、服务间调用 + 负载均衡

1. @RestController
2. @RequestMapping("/user")
3. @RequiredArgsConstructor
4. public class UserController {
6.     private final RestTemplate restTemplate;
7.     private final DiscoveryClient discoveryClient;
9.     // 方式1：使用RestTemplate + LoadBalancer
10.     @GetMapping("/{id}")
11.     public User getUser(@PathVariable Long id) {
12.         return restTemplate.getForObject(
13.             "http://service-order/order/" + id,
14.             Order.class
15.         );
16.     }
18.     // 方式2：使用OpenFeign（推荐）
19.     // 定义Feign接口
20. }
22. // Feign接口
23. @FeignClient(name = "service-order")
24. public interface OrderFeignClient {
25.     @GetMapping("/order/{userId}")
26.     List<Order> getOrdersByUserId(@PathVariable Long userId);
27. }
29. // 在启动类上添加
30. @EnableFeignClients

复制代码

六、负载均衡策略配置

1. # application.yml
2. service-order:
3.   ribbon:
4.     NFLoadBalancerRuleClassName: com.netflix.loadbalancer.RandomRule
6. # 或通过配置类
7. @Configuration
8. public class LoadBalancerConfig {
9.     @Bean
10.     public ReactorLoadBalancer<ServiceInstance> randomLoadBalancer(
11.             Environment environment, LoadBalancerClientFactory factory) {
12.         String name = environment.getProperty(LoadBalancerClientFactory.PROPERTY_NAME);
13.         return new RandomLoadBalancer(
14.             factory.getLazyProvider(name, ServiceInstanceListSupplier.class),
15.             name
16.         );
17.     }
18. }

复制代码

七、完整启动流程

• 启动 Nacos（8848）
  
• 启动 service-user（8081）
  
• 启动 service-order（8082）
  
• 启动 service-gateway（8080）
  
• 访问 http://localhost:8080/api/user/1
  

八、常见问题

• 服务注册失败？ 检查Nacos地址和namespace配置
  
• 网关503？ 确认下游服务已启动并注册到Nacos
  
• 负载均衡不生效？ 确认使用了 lb:// 协议前缀
  

总结

本文完整搭建了Nacos + Gateway + LoadBalancer的微服务架构。核心要点：服务注册发现让服务解耦，网关统一入口，负载均衡实现高可用。后续可加入Sentinel限流、Seata分布式事务等组件。
本文由AI辅助创作。

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！