SYSTEM
模块拆分思路
src/content/notes/blog-dev/模块拆分思路.md 三、模块拆分思路
3.1 blog-common(公共模块)
定位:只放被多个服务共享的通用代码,不启动、不注册到 Nacos。
包含:
Result<T>— 统一返回格式PageResult<T>— 分页返回GlobalExceptionHandler— 全局异常处理
依赖最小化原则:
<!-- 只需 spring-web 注解 + spring-data-commons 的 Page -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
注意:这两个依赖在 Gateway 中会引入 Tomcat 和 JPA,需要排除。
3.2 blog-gateway(网关)
职责:统一入口、路由分发、跨域处理。
关键设计决策:
- 不引入 Spring Security(鉴权由各服务自行处理,避免 Gateway 和业务服务双重鉴权冲突)
- 排除
spring-boot-starter-tomcat(与 Netty 冲突) - 排除
spring-boot-starter-data-jpa(Gateway 不需要数据库) - 使用 SC 2025.0.0 新 key:
spring.cloud.gateway.server.webflux.* - 公共配置
blog-common.yaml从 Nacos 拉取,但不使用其中 JWT/DB/Redis 配置
路由设计:
/api/user/** → lb://blog-user-service(8081)
/api/article/** → lb://blog-article-service(8082)
/api/category/** → lb://blog-article-service(8082)
/api/comment/** → lb://blog-article-service(8082)
3.3 blog-user-service(用户服务)
职责:用户注册、登录、JWT 签发、个人信息管理。
迁移清单:
| 从单体迁移 | 包路径变化 |
|---|---|
com.blog.blog.entity.User |
com.blog.user.entity.User |
com.blog.blog.repository.UserRepository |
com.blog.user.repository.UserRepository |
com.blog.blog.service.UserService |
com.blog.user.service.UserService |
com.blog.blog.controller.UserController |
com.blog.user.controller.UserController |
com.blog.blog.security.JwtUtil |
com.blog.user.security.JwtUtil |
com.blog.blog.config.RedisConfig |
com.blog.user.config.RedisConfig |
com.blog.blog.util.RedisUtil |
com.blog.user.util.RedisUtil |
关键问题:JwtUtil 放在 security 包而非 util 包——因为 JWT 是认证基础设施,属于安全域,不是通用工具。controller 依赖 security 层是合理的。
3.4 blog-article-service(文章服务)
职责:文章 CRUD、分类管理、评论管理。
Phase 2 简化原则(当前阶段):
- 纯 JPA CRUD,不做 Redis 缓存
- 不做跨服务调用(查 User 昵称)
- 不做消息队列(RabbitMQ 通知)
- 评论的
userId暂时由请求参数传入(Phase 3 改为从 JWT 解析)
迁移清单:
| 从单体迁移 | 包路径变化 |
|---|---|
com.blog.blog.entity.Article |
com.blog.article.entity.Article |
com.blog.blog.entity.Category |
com.blog.article.entity.Category |
com.blog.blog.entity.Comment |
com.blog.article.entity.Comment |
com.blog.blog.repository.* |
com.blog.article.repository.* |
com.blog.blog.service.* |
com.blog.article.service.* |
com.blog.blog.controller.* |
com.blog.article.controller.* |