微服务毕业设计：从单体到分布式架构的实战避坑指南-编程实验室

1. 背景痛点：为什么“拆服务”比“写代码”更难

第一次做毕设，很多同学把“微服务”当成“多建几个 Maven 模块”，结果踩坑三连：

过度拆分：用户、角色、权限三张表硬是拆成三个服务，本地启动一次要 8 个端口，笔记本风扇直接起飞。
忽略容错：OpenFeign 调用没加@Retryer，对方一超时，前端立刻 500，毕设答辩现场翻车。
本地调试困难：每个服务都有自己的 DB，链路一断，日志分散在 6 个窗口，找 BUG 像玩“大家来找茬”。

一句话：微服务不是“小服务”的简单堆叠，而是“高内聚、低耦合”的架构思维——先想清楚边界，再谈技术。

2. 技术选型：Spring Cloud Alibaba 还是 Dubbo？

本科毕设资源有限，选框架先看“轻量”与“社区活跃度”。

维度	Spring Cloud Alibaba	Dubbo
依赖体积	一套 starter，Maven 坐标 10 来个	核心 + 注册中心 + 监控，起步 20+
注册中心	Nacos（同时支持 AP/CP）	Zookeeper/Naocs 可选，ZK 偏 CP
编码风格	注解+Feign 接口，与 SpringMVC 无缝	XML/注解混合，学习曲线陡
运维工具	Nacos 控制台一键上下线	Dubbo-Admin 功能强但部署重
毕设场景	快速出活、文档丰富	性能极致、接口级治理

结论：轻量级校园系统，Spring Cloud Alibaba 更省头发；如果导师非要 QPS 压测 5w TPS，再考虑 Dubbo。

3. 核心实现：以“用户管理+课程选课”为例

3.1 服务边界划分

用户服务（user-service）：注册、登录、JWT 颁发。
课程服务（course-service）：课程 CRUD、库存扣减。
选课服务（enroll-service）：聚合用户与课程，负责幂等选课、异步减库存。

选课服务不直接操作 user 表，只通过 Feign 查询；课程服务同理——保证“单向依赖”，避免循环调用。

3.2 API 设计原则

URL 语义化：POST /courses/{id}/enrollment
统一返回体：Result<T>包装 code、msg、data
接口无状态：JWT 存 Header，服务端不存 Session

3.3 异步解耦策略

选课成功后，选课服务发送EnrollmentEvent到 RocketMQ，课程服务监听后再真正扣库存，减少长事务。

4. 代码示例：Clean Code 最小可运行集

4.1 注册中心 & 配置中心

bootstrap.yml（所有服务共用）

spring: application: name: user-service cloud: nacos: discovery: server-addr: 127.0.0.1:8848 config: server-addr: 127.0.0.1:8848 file-extension: yaml shared-configs[0]: >@RestController @RequiredArgsConstructor public class UserController { private final UserService userService; @GetMapping("/users/{uid}") public Result<UserDto> getUser(@PathVariable Long uid) { // 防御式编程：空 ID 直接 404 return Result.ok(userService.find(uid).orElseThrow(NotFound::new)); } }

4.3 选课服务（消费者）

@FeignClient(name = "user-service", fallback = UserClientFallback.class) public interface UserClient { @GetMapping("/users/{uid}") Result<UserDto> getUser(@PathVariable("uid") Long uid); } @Service public class EnrollmentService { @Autowired private UserClient userClient; // 远程调用 @Autowired private CourseClient courseClient; @Autowired private EnrollmentMapper mapper; @Transactional public Result<String> enroll(Long uid, Long courseId) { // 1. 幂等校验：同一用户 10 分钟内不能重复选 if (mapper.exists(uid, courseId)) { return Result.fail("已选过"); } // 2. 查询用户 & 课程 UserDto user = userClient.getUser(uid).getData(); CourseDto course = courseClient.getCourse(courseId).getData(); // 3. 发送异步事件 eventProducer.send(new EnrollmentEvent(uid, courseId)); return Result.ok("选课申请已提交"); } }

4.4 关键注解说明

@FeignClient(fallback = ...)：本地失败降级，避免级联错误。
shared-configs：把 MySQL、Redis、日志等公共配置下沉，修改一次、全部动态刷新。

5. 性能与安全：别让“毕设”变成“攻击靶”

冷启动延迟
Spring Boot 原生镜像 200 MB，引入spring-context-indexer+lazy-init，启动时间从 18 s → 9 s。
接口幂等性
选课服务用“唯一索引 + 分布式锁”双保险：
- 数据库层：(user_id, course_id, date)唯一索引
- 应用层：RedisSET NX EX 5防并发重入
敏感配置加密
Nacos 2.2 支持AES对称加密，把mysql.password写成cipher-mysql-common.yaml，启动时自动解密，避免明文入库。

6. 生产环境避坑指南

日志聚合：Filebeat → Elasticsearch → Kibana，链路追踪用 Spring Cloud Sleuth + Zipkin，一个traceId贯穿所有服务。
本地联调：
1. 使用 Nacosnamespace=dev隔离测试数据；
2. 开启spring.profiles.active=local，Feign 接口走localhost:8081直连，节省注册时间。
Docker 镜像优化：
1. 多阶段构建，把mvn package与运行镜像分离，最终体积 120 MB；
2. 统一基础镜像eclipse-temurin:17-jre-alpine，减少重复拉取层。