SYSTEM
博客系统:Spring Boot + Vue3 全栈实践
src/content/notes/projects/blog-system.md 一句话定位
一个可上线的个人博客系统,覆盖用户、文章、分类、评论、点赞、通知、AI 摘要七个模块,并完成了从单体到微服务的服务拆分与治理实验。
技术栈
| 层 | 选型 |
|---|---|
| 单体后端 | Spring Boot 4 + Java 17、Spring Security + JWT、Spring Data JPA |
| 微服务版 | Spring Cloud Alibaba、Gateway、Nacos、Feign、Sentinel |
| 存储与中间件 | MySQL 8、Redis 7、RabbitMQ 3.13、Redisson |
| 前端 | Vue 3 + Vite + Tailwind CSS、SockJS + STOMP |
| 外部能力 | DeepSeek API(AI 摘要) |
整体架构
浏览器 (Vue3 SPA)
|
v
Nginx :80 --- 托管 dist 静态资源
| |-- /api -> 127.0.0.1:8088
| '-- /ws -> 127.0.0.1:8088 (WebSocket)
v
Spring Boot jar :8088 (systemd 常驻)
|-- MySQL 8 (docker, 127.0.0.1:3306)
|-- Redis 7 (docker, 127.0.0.1:6379)
|-- RabbitMQ (docker, 127.0.0.1:5672)
'-- DeepSeek API (外部)
中间件全部只绑回环地址,安全组仅放行 22 / 80 / 443,数据库与消息队列不暴露公网。
三个关键取舍
1. 先单体,后微服务
没有一上来就做微服务。单体版本先把业务跑通、把缓存和消息队列的价值验证清楚,再按「用户 / 文章」两条业务边界拆成 blog-user-service 与 blog-article-service,用 Gateway 统一入口、Nacos 做注册、Feign 做远程调用、Sentinel 做限流熔断。
原因:单人项目里微服务的收益(独立部署、故障隔离)并不成立,成本(链路排查、分布式事务、运维)却是实打实的。拆分的价值在于证明我理解边界怎么划,而不是让线上跑得更快。
2. 数据访问用 JPA 而不是 MyBatis
实体与表结构强绑定,ddl-auto: update 让开发期无需手写建表脚本;分页、排序、条件查询由 Specification 覆盖,减少 XML 维护。代价是复杂 SQL 的可控性弱于 MyBatis,所以热点排行这类查询单独走手写 SQL。
3. 热点数据用 Redis 而不是本地缓存
多实例部署时本地缓存无法保证一致性。方案是「Redis 缓存 + 布隆过滤器防穿透 + 分布式锁防击穿 + 随机过期时间防雪崩」,并给排行接口加了令牌桶限流。
踩坑复盘:布隆过滤器的误判与预热
第一版把布隆过滤器直接挂在查询入口,文章发布后立刻查询却返回「不存在」。原因是过滤器只在启动时按库内已有数据初始化,新增 ID 没有写入。
修复方式:
- 文章创建成功后同步
put到过滤器; - 过滤器启动时全量预热,并对误判率按预期数据量估算位数组长度;
- 过滤器判断不存在时直接返回,判断存在才继续查 Redis / DB,避免误判导致的数据不可见被放大。
教训:过滤器只能当「快速否定」用,不能当唯一真相源。
结果与产出
- 线上部署:Docker Compose 管中间件,jar 由 systemd 常驻,Nginx 托管前端并反代
/api、/ws - 完整接口文档与后端架构文档(鉴权链路、缓存策略、MQ 可靠性)
- 微服务版保留在同一仓库,作为架构演进的对照实现
相关链接
- 源码:待补充 GitHub 地址
- 在线 Demo:待服务器恢复后开放
- 演示录屏:待录制