13 KiB

Raw Blame History

Nacos注册中心

注册中心

服务发现

发现服务信息。

@SpringBootTest()
public class DiscoveryTest {

    @Autowired
    private DiscoveryClient discoveryClient;

    @Autowired
    private NacosDiscoveryClient nacosDiscoveryClient;

    @Test
    void discoveryClientTest() {
        for (String service : discoveryClient.getServices()) {
            System.out.println(service);

            for (ServiceInstance instance : discoveryClient.getInstances(service)) {
                System.out.println("IP地址：" + instance.getHost());
                System.out.println("端口号" + instance.getPort());
            }
        }

        System.out.println("----------------------------------------------");

        // 两个方式一样，DiscoveryClient 是 Spring自带的 NacosDiscoveryClient是 Nacos
        for (String service : nacosDiscoveryClient.getServices()) {
            System.out.println(service);

            for (ServiceInstance instance : nacosDiscoveryClient.getInstances(service)) {
                System.out.println("IP地址：" + instance.getHost());
                System.out.println("端口号" + instance.getPort());
            }
        }
    }
}

远程调用

订单模块调用远程商品模块，使用了nacos，可以使用RestTemplate，其中RestTemplate是线程安全的，只要注册一次全局都是可以使用。

RestTemplate源码

继承了InterceptingHttpAccessor，在InterceptingHttpAccessor中，使用了单例模式。

public ClientHttpRequestFactory getRequestFactory() {
    List<ClientHttpRequestInterceptor> interceptors = this.getInterceptors();
    if (!CollectionUtils.isEmpty(interceptors)) {
        ClientHttpRequestFactory factory = this.interceptingRequestFactory;
        if (factory == null) {
            factory = new InterceptingClientHttpRequestFactory(super.getRequestFactory(), interceptors);
            this.interceptingRequestFactory = factory;
        }

        return factory;
    } else {
        return super.getRequestFactory();
    }
}

实现远程调用

普通方式调用

@Bean
public RestTemplate restTemplate() {
    return new RestTemplate();
}

如果我们的服务启动了多个，在下面代码中即使一个服务宕机也可以做到远程调用。

private Product getProductFromRemote(Long productId) {
    // 获取商品服务所有及其的 IP+port
    List<ServiceInstance> instances = discoveryClient.getInstances("service-product");
    ServiceInstance instance = instances.get(0);

    // 远程URL
    String url = "http://" + instance.getHost() + ":" + instance.getPort() + "/api/product/" + productId;

    // 2. 远程发送请求
    log.info("远程调用：{}", url);
    return restTemplate.getForObject(url, Product.class);
}

负载均衡调用

@Bean
public RestTemplate restTemplate() {
    return new RestTemplate();
}

使用负载均衡LoadBalancerClient，通过负载均衡算法动态调用远程服务。

/**
 * 远程调用商品模块 --- 负载均衡
 *
 * @param productId 商品id
 * @return 商品对象
 */
private Product getProductFromRemoteWithLoadBalancer(Long productId) {
    // 1. 获取商品服务所有及其的 IP+port
    ServiceInstance instance = loadBalancerClient.choose("service-product");

    // 远程URL
    String url = "http://" + instance.getHost() + ":" + instance.getPort() + "/api/product/" + productId;

    // 2. 远程发送请求
    log.info("负载均衡远程调用：{}", url);
    return restTemplate.getForObject(url, Product.class);
}

负载均衡注解调用

[!TIP]

如果远程注册中心宕机是否可以调用？

调用过：远程调用不在依赖注册中心，可以通过。

没调用过：第一次发起远程调用；不能通过。

在RestTemplate上加上@LoadBalanced注解使用负载均衡。

@Bean
@LoadBalanced
public RestTemplate restTemplate() {
    return new RestTemplate();
}

在实际的调用中并不需要再显式调用，将URL替换成服务名称即可。

/**
 * 远程调用商品模块 --- 负载均衡注解调用
 *
 * @param productId 商品id
 * @return 商品对象
 */
private Product getProductFromRemoteWithLoadBalancerAnnotation(Long productId) {
    // 远程URL，实现动态替换
    String url = "http://service-product/api/product/" + productId;

    // 远程发送请求
    log.info("负载均衡注解调用：{}", url);
    return restTemplate.getForObject(url, Product.class);
}

按需加载

数据隔离架构

命名空间管理

创建命名空间

[!TIP] 预配置的命名空间示例可在项目 samples/namespace-config 目录下找到。

建议创建以下标准命名空间：

dev - 开发环境
test - 测试环境
prod - 生产环境

操作步骤：

进入Nacos控制台命名空间管理
点击"新建命名空间"
填写命名空间信息（ID和名称）

配置管理

开发环境配置示例：

基础配置：

order:
  timeout: 1min
  auto-confirm: 1h

数据库配置：

order:
  db-url: jdbc:mysql://dev-db:3306/order_dev

命名空间克隆

通过克隆功能快速创建相似环境的命名空间：

动态环境配置

Spring Boot 配置方案

基础配置：

server:
  port: 8000
spring:
  application:
    name: service-order
  profiles:
    active: dev
  cloud:
    nacos:
      server-addr: ${NACOS_HOST:192.168.95.135}:8848
      config:
        namespace: ${spring.profiles.active:dev} # 动态匹配当前profile
        group: DEFAULT_GROUP

多环境配置加载：

spring:
  config:
    import:
      - optional:nacos:service-order.yml
      - optional:nacos:common.yml?group=order
      - optional:nacos:database.yml?group=order

[!NOTE] 使用optional:前缀可避免配置不存在时启动失败

配置读取实现

配置类：

@Configuration
@ConfigurationProperties(prefix = "order")
@Getter
@Setter
public class OrderProperties {
    private String timeout;
    private String autoConfirm;
    private String dbUrl; // 自动映射db-url
}

REST接口：

@RestController
@RequestMapping("/api/order")
@RequiredArgsConstructor
public class OrderController {
    private final OrderProperties orderProperties;

    @GetMapping("/config")
    public Map<String, String> getConfig() {
        return Map.of(
            "timeout", orderProperties.getTimeout(),
            "autoConfirm", orderProperties.getAutoConfirm(),
            "dbUrl", orderProperties.getDbUrl()
        );
    }
}

按需加载策略

多环境差异化配置

spring:
  profiles:
    active: prod # 可通过启动参数覆盖

---
# 生产环境配置
spring:
  config:
    import:
      - nacos:service-order-prod.yml
      - nacos:common-prod.yml?group=order
    activate:
      on-profile: prod

---
# 开发环境配置
spring:
  config:
    import:
      - nacos:service-order-dev.yml
      - nacos:database-dev.yml?group=order
    activate:
      on-profile: dev

---
# 测试环境配置
spring:
  config:
    import:
      - nacos:service-order-test.yml
      - nacos:database-test.yml?group=order
    activate:
      on-profile: test

OpenFeign 使用

基础配置

依赖引入

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
    <version>${spring-cloud.version}</version>
</dependency>

启用Feign客户端

@SpringBootApplication
@EnableFeignClients(basePackages = "com.yourpackage.feign")
public class OrderServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class, args);
    }
}

[!NOTE] @EnableDiscoveryClient注解，Spring Cloud最新版本已自动启用服务发现功能。

Feign客户端使用

服务间调用

Feign客户端定义：

@FeignClient(
    name = "service-product",  
    path = "/api/product",
    configuration = ProductFeignConfig.class
)
public interface ProductFeignClient {

    @GetMapping("/{id}")
    ResponseEntity<Product> getProductById(@PathVariable("id") Long productId);

    @PostMapping
    ResponseEntity<Void> createProduct(@Valid @RequestBody Product product);  // 添加@Valid注解支持参数校验
}

服务调用示例优化：

@Service
@RequiredArgsConstructor
public class OrderService {
    private final ProductFeignClient productFeignClient;

    public Order createOrder(Long productId, Long userId) {
        Product product = productFeignClient.getProductById(productId)
            .orElseThrow(() -> new ProductNotFoundException(productId));  // 使用Optional简化判断
        
        return Order.builder()
            .productId(product.getId())
            .userId(userId)
            // 其他订单属性
            .build();
    }
}

第三方服务调用优化

@FeignClient(
    name = "bunny-client",
    url = "${external.bunny.api.url}",
    configuration = ExternalFeignConfig.class
)
public interface BunnyFeignClient {

    @PostMapping("/login")
    ResponseEntity<AuthResponse> login(@Valid @RequestBody LoginDto loginDto);  // 使用具体返回类型替代String
}

负载均衡对比

特性	客户端负载均衡 (OpenFeign)	服务端负载均衡 (Nginx等)
实现位置	客户端实现	服务端实现
依赖关系	需要服务注册中心	不依赖注册中心
性能	直接调用，减少网络跳转	需要经过代理服务器
灵活性	可定制负载均衡策略	配置相对固定
服务发现	集成服务发现机制	需要手动维护服务列表
适用场景	微服务内部调用	对外暴露API或跨系统调用
容错能力	集成熔断机制（如Sentinel、Hystrix）	依赖代理服务器容错配置

高级配置

日志配置优化

application.yml:

logging:
  level:
    org.springframework.cloud.openfeign: DEBUG
    com.yourpackage.feign: DEBUG

Java配置：

@Configuration
public class FeignConfig {
    
    @Bean
    Logger.Level feignLoggerLevel() {
        // 生产环境建议使用BASIC级别
        return Logger.Level.FULL; 
    }
}

超时与重试配置优化