SpringCloud微服务框架搭建指南（基于Nacos）

SpringCloud微服务框架搭建指南（基于Nacos）

1. 概述

SpringCloud是一套完整的微服务解决方案，而Nacos是阿里巴巴开源的服务发现和配置管理平台，本文将详细介绍如何在Windows环境下搭建基于Nacos的SpringCloud微服务框架。

2. 环境准备

• JDK 1.8+（推荐1.8）
• Maven 3.0+
• Windows操作系统
• Spring Boot 2.3.x（兼容性较好）
• Spring Cloud Hoxton版本
• Spring Cloud Alibaba 2.2.x

3. 在Windows上安装Nacos

3.1 下载Nacos

1. 访问Nacos官方GitHub发布页面：https://github.com/alibaba/nacos/releases
2. 下载最新稳定版本的压缩包（例如：nacos-server-2.0.3.zip）
3. 将下载的压缩包解压到本地目录（路径最好不要有中文和空格）

3.2 配置Nacos

1. 进入Nacos解压目录，找到conf文件夹
2. 打开application.properties文件
3. 默认配置已经适用于单机模式，可以直接使用
4. 若需要修改端口号（默认为8848），找到server.port=8848行进行修改

3.3 启动Nacos

1. 进入Nacos解压目录下的bin文件夹
2. 打开命令提示符（以管理员身份运行）
3. 输入以下命令启动Nacos服务器：

   startup.cmd -m standalone
   

4. 等待启动完成，看到"Nacos started successfully"表示启动成功
5. 打开浏览器访问：http://localhost:8848/nacos
6. 使用默认账号密码登录（用户名：nacos，密码：nacos）

4. 创建SpringCloud微服务项目

4.1 创建父工程

1. 使用IDE（如IntelliJ IDEA）创建一个Maven项目
2. 配置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">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>MicroservicesNacos</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <spring.boot.version>2.6.13</spring.boot.version>
        <spring.cloud.version>2021.0.5</spring.cloud.version>
        <spring.cloud.alibaba.version>2021.0.4.0</spring.cloud.alibaba.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <!-- Spring Boot -->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring.boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!-- Spring Cloud -->
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring.cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!-- Spring Cloud Alibaba -->
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring.cloud.alibaba.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>

    </dependencyManagement>

    <modules>
        <!-- 子模块将在这里添加 -->
    </modules>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>${spring.boot.version}</version>
            </plugin>
        </plugins>
    </build>
</project>

4.2 创建公共模块

1. 在父工程下创建一个名为common的Maven模块
2. 配置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>MicroservicesNacos</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>common</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.78</version>
        </dependency>
    </dependencies>
</project>

1. 创建实体类和通用响应对象

// com.example.common.entity.User.java
package com.example.common.entity;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.io.Serializable;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class User implements Serializable {
    private Long id;
    private String name;
    private Integer age;
    privat