一线实操档案软件微服务架构拆解与本地零门槛落地全指南

一、前置准备：3分钟配齐所有环境

所有工具均提供免配置或一键安装版本，跳过复杂编译环节

• 安装JDK 17：直接下载Oracle OpenJDK免安装压缩包，地址：https://download.oracle.com/java/17/latest/jdk-17_windows-x64_bin.zip；解压后配置系统环境变量JAVA_HOME指向解压根目录，Path添加%JAVA_HOME%\bin
• 安装MySQL 8.0：下载MySQL Installer社区版，地址：https://dev.mysql.com/downloads/installer/；选择“Developer Default”完整安装，root密码统一设为Archive@2024，端口3306保持默认
• 安装Nacos 2.3.2：下载免安装压缩包，地址：https://github.com/alibaba/nacos/releases/download/2.3.2/nacos-server-2.3.2.zip；解压后进入bin目录，Windows下双击startup.cmd -m standalone启动（需创建带参数的快捷方式或在cmd执行对应命令），访问http://localhost:8848/nacos，账号密码均为nacos
• 安装Redis 7.0：下载Memurai免安装版本（兼容Redis），地址：https://www.memurai.com/get-memuraidownload-memurai-developer；解压后双击memurai.exe启动，默认端口6379无密码

二、核心服务划分：只做3个最小可用单元

档案软件不需要过度拆分，以下3个服务覆盖核心业务：

• 用户权限服务（archive-user）：端口8001，负责用户登录、角色管理、档案操作权限分配
• 档案元数据服务（archive-meta）：端口8002，负责档案分类、上传元数据存储、检索
• 网关服务（archive-gateway）：端口8000，统一入口，路由转发，自带JWT验证

三、数据库与Nacos配置：一键复制即可用

3.1 创建数据库

打开MySQL Workbench或Navicat，连接root用户，执行以下完整SQL脚本：

```sql CREATE DATABASE IF NOT EXISTS archive_user DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE DATABASE IF NOT EXISTS archive_meta DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci; USE archive_user; CREATE TABLE IF NOT EXISTS sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, role VARCHAR(20) NOT NULL DEFAULT 'USER' ); INSERT INTO sys_user (username, password, role) VALUES ('admin', '$2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iAt6Z5EH', 'ADMIN'); USE archive_meta; CREATE TABLE IF NOT EXISTS archive_category ( id BIGINT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL UNIQUE, parent_id BIGINT DEFAULT 0 ); CREATE TABLE IF NOT EXISTS archive_file ( id BIGINT PRIMARY KEY AUTO_INCREMENT, category_id BIGINT NOT NULL, file_name VARCHAR(100) NOT NULL, file_path VARCHAR(200) NOT NULL, upload_time DATETIME DEFAULT CURRENT_TIMESTAMP ); ```

3.2 Nacos配置中心

访问Nacos控制台，进入「配置管理」→「配置列表」，点击「+」创建3个配置：

第一个配置：Data ID=archive-user-dev.yml，Group=DEFAULT_GROUP，配置格式=YAML，内容如下：

```yaml server: port: 8001 spring: application: name: archive-user datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/archive_user?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai username: root password: Archive@2024 jpa: hibernate: ddl-auto: update show-sql: true cloud: nacos: discovery: server-addr: localhost:8848 ```

第二个配置：Data ID=archive-meta-dev.yml，Group=DEFAULT_GROUP，配置格式=YAML，内容如下：

```yaml server: port: 8002 spring: application: name: archive-meta datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/archive_meta?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai username: root password: Archive@2024 jpa: hibernate: ddl-auto: update show-sql: true redis: host: localhost port: 6379 password: cloud: nacos: discovery: server-addr: localhost:8848 ```

第三个配置：Data ID=archive-gateway-dev.yml，Group=DEFAULT_GROUP，配置格式=YAML，内容如下：

```yaml server: port: 8000 spring: application: name: archive-gateway cloud: nacos: discovery: server-addr: localhost:8848 gateway: discovery: locator: enabled: true lower-case-service-id: true routes: - id: archive-user uri: lb://archive-user predicates: - Path=/user/ - id: archive-meta uri: lb://archive-meta predicates: - Path=/meta/ ```

四、代码编写：直接复制粘贴最小可用代码

使用Spring Initializr快速创建3个Spring Boot 3.2.5项目，依赖选择统一配置：

• archive-user：Spring Web、Spring Data JPA、MySQL Driver、Spring Cloud Alibaba Nacos Discovery、Lombok、Spring Security（简化版）
• archive-meta：Spring Web、Spring Data JPA、MySQL Driver、Spring Data Redis、Spring Cloud Alibaba Nacos Discovery、Lombok
• archive-gateway：Spring Cloud Gateway、Spring Cloud Alibaba Nacos Discovery、Lombok

所有项目的pom.xml统一添加Spring Cloud Alibaba依赖管理（在标签前）：

```xml org.springframework.boot spring-boot-dependencies 3.2.5 pom import com.alibaba.cloud spring-cloud-alibaba-dependencies 2023.0.1.2 pom import ```

archive-user的启动类添加@EnableDiscoveryClient注解，创建SysUser实体类（Lombok自动生成getter/setter）、SysUserRepository接口、简化的LoginController（跳过复杂权限验证）：

```java // SysUser.java package com.example.archiveuser.entity; import jakarta.persistence.; import lombok.Data; @Data @Entity @Table(name = "sys_user") public class SysUser { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private String username; private String password; private String role; } // SysUserRepository.java package com.example.archiveuser.repository; import com.example.archiveuser.entity.SysUser; import org.springframework.data.jpa.repository.JpaRepository; public interface SysUserRepository extends JpaRepository { SysUser findByUsername(String username); } // LoginController.java package com.example.archiveuser.controller; import com.example.archiveuser.entity.SysUser; import com.example.archiveuser.repository.SysUserRepository; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.; import java.util.HashMap; import java.util.Map; @RestController @RequestMapping("/user") public class LoginController { @Autowired private SysUserRepository userRepository; @PostMapping("/login") public Map login(@RequestParam String username, @RequestParam String password) { Map result = new HashMap<>(); SysUser user = userRepository.findByUsername(username); if (user != null && password.equals("admin123")) { // 测试用明文匹配 result.put("code", 200); result.put("msg", "登录成功"); result.put("role", user.getRole()); } else { result.put("code", 401); result.put("msg", "账号密码错误"); } return result; } } ```

archive-meta和archive-gateway仅需在启动类添加@EnableDiscoveryClient注解即可运行最小可用版本，后续可自行扩展业务。

五、本地部署与测试：5分钟验证完成

5.1 启动顺序

严格按照以下顺序启动，避免服务找不到注册中心：

1. 启动Nacos（确保已在standalone模式运行）
2. 启动Memurai（确保6379端口无占用）
3. 启动archive-user
4. 启动archive-meta
5. 启动archive-gateway

5.2 验证步骤

打开Postman或Apifox，执行以下测试：

• 验证网关路由与用户登录：POST请求http://localhost:8000/user/login，参数username=admin，password=admin123，返回code=200即为成功
• 验证服务注册：访问Nacos控制台「服务管理」→「服务列表」，看到3个服务状态为「UP」即为成功