SYSTEM
完善分类管理列表
src/content/notes/blog-dev/完善分类管理列表.md 完善分类管理列表
问题:目前分类筛选是前端本地过滤,不是后端分页查询
解决方案:后端 /api/article/list 接口不支持 categoryId 参数,只能查询全部文章。主要修改大的是前端部分。
| 文件 | 改动 |
|---|---|
| ArticleRepository.java | 新增 findByCategoryIdOrderByCreateTimeDesc 方法 |
| ArticleService.java | getAllArticlesPage 方法签名增加 categoryId 参数 |
| ArticleServiceImpl.java | 实现分类分页查询逻辑,缓存 key 按分类区分(:cat:{categoryId}) |
| ArticleController.java | /list 接口增加可选参数 categoryId |
- ArticleRepository.java- 添加按分类分页查询方法
// 按分类分页查询,按创建时间倒序
Page<Article> findByCategoryIdOrderByCreateTimeDesc(String categoryId, Pageable pageable);
- ArticleService.java-接口增加 categoryId 参数
PageResult<Article> getAllArticlesPage(int page, int size, String categoryId);
- ArticleServiceImpl.java- 实现分类分页逻辑和对应缓存
@Override
public PageResult<Article> getAllArticlesPage(int page, int size, String categoryId) {
if (page < 0) page = 0;
if (size <= 0) size = 10;
// 3. 缓存未命中:从数据库查询(排序规则封装在 Repository 方法中)
Pageable pageable = PageRequest.of(page, size);
Page<Article> pageResult;
if (hasCategory) {
pageResult = articleRepository.findByCategoryIdOrderByCreateTimeDesc(categoryId, pageable);
} else {
pageResult = articleRepository.findAllByOrderByCreateTimeDesc(pageable);
}
return PageResult.of(pageResult);
}
- ArticleController.java - 接口增加 categoryId 参数
@GetMapping("/list")
public Result<PageResult<Article>> getAllArticles(
@RequestParam(defaultValue = "0") int page,
@RequestParam(defaultValue = "10") int size,
@RequestParam(required = false) String categoryId) {
PageResult<Article> articles = articleService.getAllArticlesPage(page, size, categoryId);
return Result.success(articles);
}
- 剩下前端全都可以使用ai完成:
方案:当前页面切换视图模式
思路:分类管理页面保持两个视图状态——“分类列表”和”分类文章列表”,点击”查看”后切换到文章列表视图,带返回按钮。
交互流程:
分类管理页面
└─ 点击"查看"按钮 ──→ 切换到文章列表视图(调用后端分类分页接口)
├─ 点击文章 ──→ 跳转到文章详情页
├─ 点击分页 ──→ 加载该分类下一页文章
└─ 点击"返回分类列表" ──→ 回到分类管理视图
解决 Redis 缓存三大问题(穿透/击穿/雪崩)
- ArticleServiceImpl.java:
新增常量:
├── NULL_CACHE_EXPIRE = 60L → 空值缓存统一过期时间
├── UNLOCK_SCRIPT → Lua脚本:安全释放锁
└── RANDOM(已有静态变量,现在统一使用)
clearRelatedCaches()(Bug2+Bug3):
├── deleteByPattern("article:list:page:*") → 删除所有分页缓存(含分类)
├── deleteByPattern("article:total:count*") → 删除所有总数缓存(含分类)
└── 删除详情/排行缓存 → 保持不变
getArticle()(Bug1 + 问题1 + 问题4a):
├── 缓存命中检查 "NULL" 标记 → 直接抛异常不查库(穿透防护)
├── redisUtil.setIfAbsent() 替代 redisTemplate → 编译修复
├── UUID 作为锁 value → Lua脚本安全释放 → 不会误删别人的锁
├── 锁超时 3s → 10s → 给数据库查询足够时间
└── 查不到文章 → 缓存 "NULL" + 60s TTL(穿透防护)
getAllArticlesPage()(问题7):
└── new Random() → 静态 RANDOM
getAllArticles()(问题2 + 问题6):
├── 空列表 → 缓存 emptyList + 60s TTL(穿透防护)
└── 非空 → 固定TTL → 基础TTL + 随机偏移(雪崩防护)
getArticleRankingByViews()(问题2 + 问题6):
└── 同 getAllArticles 模式
getArticleRankingByLatest()(问题2 + 问题6):
└── 同 getAllArticles 模式
二、缓存穿透问题(Cache Penetration)
问题 1:getArticle 未缓存空值
Article article = articleRepository.findById(id)
.orElseThrow(() -> new RuntimeException("文章不存在"));
原因:当文章 ID 不存在时,直接抛异常返回,没有缓存空值。攻击者用不同无效 ID 反复请求,每次都打到数据库。
解决思路:查不到文章时,缓存一个空标记值(如空字符串 "NULL" 或特殊对象),设置短 TTL(如 60s)。下次查询命中空标记直接返回,不查库。
问题 2:getAllArticles、getArticleRankingByViews、getArticleRankingByLatest 均无穿透防护
原因:这三个方法查到空列表后直接返回,没有缓存空值。虽然正常场景下不太可能为空(总有文章),但防御性编程应该覆盖。
解决思路:与 getAllArticlesPage 第124-128行的做法一致,查到空结果时缓存空列表 + 短 TTL。
问题 3:getAllArticlesPage 的空值缓存判断存在隐患
if (cacheObj instanceof List && totalObj instanceof Number) {
原因:当缓存了空列表(Collections.emptyList())和 0L 后,这个条件会命中,返回空列表——逻辑上正确。但问题在于:无法区分”缓存了空值”和”正常空页”。如果之后新增了文章,空值缓存未失效(见下方 Bug 2),用户会持续看到空列表。
解决思路:空值缓存的 key 加特殊后缀(如 :empty),或缓存一个标记对象区分空值缓存和正常数据。
三、缓存击穿问题(Cache Breakdown)
问题 4:getArticle 分布式锁实现有多个缺陷
缺陷 4a:锁释放不安全
redisUtil.delete(lockKey) 直接删除锁,没有校验锁的持有者。如果锁已超时(3秒)被其他线程获取,当前线程会误删别人的锁。
解决思路:锁的 value 存入唯一标识(如 UUID),释放时用 Lua 脚本判断 value 匹配后再删除。
缺陷 4b:锁超时时间过短
Duration.ofSeconds(3) ——3 秒。如果数据库查询慢或网络抖动,锁可能提前过期,导致第二个线程进入临界区。
解决思路:适当延长至 10-15 秒,或引入锁续期机制(看门狗)。
缺陷 4c:重试 3 次后直接查数据库
重试失败后直接查库,击穿防护形同虚设。高并发下锁超时会导致大量请求同时走到这里。
解决思路:重试失败后返回降级数据(如缓存旧值、默认提示),而非直接打数据库。
问题 5:getAllArticlesPage 等热查询方法无击穿防护
原因:分页列表是高频访问的热点数据,缓存过期瞬间如果有大量并发请求,会同时查库。getArticle 加了锁,但 getAllArticlesPage 没有加。
解决思路:对热点 key 采用同样的分布式锁 + 二次检查模式,或考虑使用逻辑过期方案(缓存永不过期,value 中带过期时间戳,后台异步刷新)。
四、缓存雪崩问题(Cache Avalanche)
问题 6:随机 TTL 应用不一致
原因:三个方法使用固定 TTL,同时过期会导致雪崩。
解决思路:所有缓存写入统一加随机偏移(基础 TTL ± 10%~30%)。
问题 7:静态 RANDOM 声明了但未使用
位置:声明了 static final RANDOM,但都用了 new java.util.Random()。
原因:每次调用创建新 Random 对象,浪费内存。已有静态变量却不用。
解决思路:统一使用静态 RANDOM。
五、缓存一致性问题(最严重的业务 Bug)
Bug 2:clearRelatedCaches 未清理分类相关缓存
for (int i = 0; i < 10; i++) {
redisUtil.delete(ARTICLE_LIST_PAGE_KEY + i); // 只删 article:list:page:0 ~ 9
}
redisUtil.delete(ARTICLE_TOTAL_COUNT_KEY); // 只删全局总数
原因:问题2修复后,分类分页的缓存 key 是 article:list:page:0:cat:1、article:total:count:cat:1 等格式。但 clearRelatedCaches 只删除了不带分类后缀的 key,分类相关缓存完全不会被清理。
后果:
- 新建文章后,该分类的文章列表缓存不失效,用户看不到新文章
- 删除文章后,该分类的文章列表仍显示已删除的文章
- 修改文章分类后,旧分类和新分类的缓存都不更新
解决思路:
- 方案 A:用
redisTemplate.keys("article:list:page:*")模糊匹配删除所有分页缓存(需确保 RedisUtil 支持) - 方案 B:在
RedisUtil中新增deleteByPattern方法,使用SCAN + DELETE避免阻塞 - 方案 C:维护一个分类列表,遍历所有分类组合 key 删除
Bug 3:clearRelatedCaches 只清理前 10 页
原因:for (int i = 0; i < 10; i++) 硬编码 10 页。如果文章超过 100 篇(10页 × 10条/页),第 10 页及以后的缓存不会被清理。
解决思路:同 Bug 2,用模糊匹配删除所有分页缓存。
添加首页搜索功能
原因:目前是前端本地过滤,并未使用后端请求
后端(4个文件)
| 文件 | 改动 |
|---|---|
| ArticleRepository.java | 新增 2 个搜索方法:关键词搜索 + 分类+关键词联合搜索 |
| ArticleService.java | getAllArticlesPage 方法签名增加 keyword 参数 |
| ArticleServiceImpl.java | 实现 4 分支查询(全部分类/按分类/关键词/分类+关键词),缓存 key 增加 :kw: 维度 |
| ArticleController.java | /list 接口增加 keyword 请求参数 |