Spring Cloud + Nacos 微服务从 0 到 1 搭建实战

步骤 2：创建服务提供者（nacos-provider）

1. 子工程 pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>com.example</groupId>
        <artifactId>springcloud-nacos-demo</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <artifactId>nacos-provider</artifactId>
    <dependencies>
        <!-- Spring Boot Web -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- Nacos 服务注册发现 -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>
    </dependencies>
</project>

2. 配置文件（application.yml）

server:
  port: 8081 # 提供者端口
spring:
  application:
    name: nacos-provider # 服务名称（核心，Nacos 通过这个名称识别服务）
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848 # Nacos 服务地址

3. 启动类 + 业务接口

package com.example.provider;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

// 开启服务注册发现（Nacos）
@EnableDiscoveryClient
@SpringBootApplication
public class ProviderApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProviderApplication.class, args);
    }

    // 业务接口：模拟提供数据服务
    @RestController
    class ProviderController {
        // 接口路径：/hello/{name}
        @GetMapping("/hello/{name}")
        public String hello(@PathVariable String name) {
            return "Hello " + name + "! 我是 Nacos 服务提供者";
        }
    }
}

步骤 3：创建服务消费者（nacos-consumer）

1. 子工程 pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <groupId>com.example</groupId>
        <artifactId>springcloud-nacos-demo</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <artifactId>nacos-consumer</artifactId>
    <dependencies>
        <!-- Spring Boot Web -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- Nacos 服务注册发现 -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>
        <!-- RestTemplate：用于远程调用 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-webflux</artifactId>
        </dependency>
    </dependencies>
</project>

2. 配置文件（application.yml）

server:
  port: 8082 # 消费者端口
spring:
  application:
    name: nacos-consumer # 消费者服务名称
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848 # Nacos 服务地址

3. 启动类 + 调用逻辑

package com.example.consumer;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.client.loadbalancer.LoadBalanced;
import org.springframework.context.annotation.Bean;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;

// 开启服务注册发现
@EnableDiscoveryClient
@SpringBootApplication
public class ConsumerApplication {
    public static void main(String[] args) {
        SpringApplication.run(ConsumerApplication.class, args);
    }

    // 配置 RestTemplate，开启负载均衡（@LoadBalanced）
    @Bean
    @LoadBalanced
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }

    // 消费者接口：调用提供者服务
    @RestController
    class ConsumerController {
        // 注入 RestTemplate
        private final RestTemplate restTemplate;

        // 构造器注入
        public ConsumerController(RestTemplate restTemplate) {
            this.restTemplate = restTemplate;
        }

        // 接口路径：/consumer/hello/{name}
        @GetMapping("/consumer/hello/{name}")
        public String hello(@PathVariable String name) {
            // 调用提供者服务：使用服务名称（nacos-provider）代替 IP+ 端口，实现服务发现
            String url = "http://nacos-provider/hello/" + name;
            return restTemplate.getForObject(url, String.class);
        }
    }
}

四、测试验证（5 分钟）

1. 启动 Nacos Server（确保 8848 端口正常）
2. 启动 nacos-provider（8081 端口）
3. 启动 nacos-consumer（8082 端口）
4. 访问 Nacos 控制台：http://localhost:8848/nacos，在「服务管理」→「服务列表」中能看到 nacos-provider 和 nacos-consumer 两个服务
5. 测试接口：访问 http://localhost:8082/consumer/hello/Java 微服务，返回结果：Hello Java 微服务！我是 Nacos 服务提供者，说明调用成功。

总结

1. 核心依赖：Spring Cloud Alibaba Nacos Discovery 实现服务注册与发现，RestTemplate 实现服务间远程调用。
2. 关键配置：每个微服务需配置 spring.application.name（服务名）和 spring.cloud.nacos.discovery.server-addr（Nacos 地址），且启动类需加 @EnableDiscoveryClient。
3. 核心逻辑：消费者通过服务名（而非硬编码 IP）调用提供者接口，由 Nacos 自动发现服务地址，实现微服务解耦。

这个实战项目覆盖了企业微服务开发的核心刚需：服务注册发现、跨服务调用，是 Spring Cloud + Nacos 的最小可用模型，后续可扩展配置中心、熔断降级、网关等企业级特性。