SYSTEM
后端优化与 Bug 修复 — 笔记
src/content/notes/blog-dev/后端优化与Bug修复-笔记.md 后端优化与 Bug 修复 — 笔记
一、优化背景
在完成企业级 Redis 改造后,对项目其余代码进行统一审查,发现以下问题:
- 多处使用
@Autowired字段注入,不推荐 SummaryConsumer和CacheWarmup中常量与BlogCacheConstants重复SummaryConsumer自行实现缓存清理,与CacheCleaner重复CommentServiceImpl.deleteComment逻辑错误- 评论无缓存,每次查询都走 DB
- 评论通知消费者无幂等性
- 全局异常处理粒度太粗
- 无定时任务线程池配置
- CORS 配置硬编码在 SecurityConfig 中
二、修改思路与步骤
1. SummaryConsumer 改造
问题:
- 使用
@Autowired字段注入 - 本地常量与
BlogCacheConstants重复 - 自行实现
clearRelatedCaches与CacheCleaner重复 - 注入
ArticleServiceImpl只为调用缓存清理方法,存在循环依赖风险
步骤:
- 改为
@RequiredArgsConstructor构造器注入 - 移除本地常量,全部引用
BlogCacheConstants - 移除
clearRelatedCaches方法,注入CacheCleaner调用 - 移除
ArticleServiceImpl注入
涉及文件:SummaryConsumer.java
2. CommentServiceImpl 改造
问题:
- 使用
@Autowired字段注入 deleteComment逻辑错误:findByParentId(comment.getParentId())查找的是兄弟评论,不是子回复- 无缓存,每次查询评论都走 DB
- 创建评论后未通知文章作者
步骤:
- 改为
@RequiredArgsConstructor构造器注入 - 修复 deleteComment:
findByParentId(id)查找目标评论的所有子回复,先删子回复再删评论本身 getCommentsByArticleId添加 Redis 缓存(Key:blog:comment:article:{articleId},过期 600s)createComment添加:- 清除该文章评论缓存,保证数据一致性
- 发送
CommentNotifyMessage到 RabbitMQ 异步通知文章作者 - 过滤自己评论自己的场景(不通知)
涉及文件:CommentServiceImpl.java、CommentRepository.java
3. CacheWarmup 改造
问题:
- 使用
@Autowired字段注入 - 本地常量与
BlogCacheConstants重复
步骤:
- 改为
@RequiredArgsConstructor构造器注入 - 所有常量替换为
BlogCacheConstants引用
涉及文件:CacheWarmup.java
4. CommentNotifyConsumer 幂等性
问题:RabbitMQ 可能重复投递消息,消费者未做幂等性处理。
步骤:
- 改为
@RequiredArgsConstructor构造器注入 - 基于
articleId + commentUserId + timestamp构造唯一 Key - 用
redisUtil.setIfAbsent做 SET NX 去重,24 小时过期 - 重复消息直接 ACK 跳过,不进入后续逻辑
涉及文件:CommentNotifyConsumer.java
5. GlobalExceptionHandler 细粒度处理
问题:只有 RuntimeException 和 Exception 两个兜底,缺少具体异常类型。
步骤:新增以下异常处理器:
| 异常类型 | 返回信息 |
|---|---|
MethodArgumentNotValidException |
参数校验失败详情(字段名 + 错误原因) |
MissingServletRequestParameterException |
缺少必要参数 |
HttpMessageNotReadableException |
请求数据格式错误 |
DataIntegrityViolationException |
数据冲突(如唯一约束) |
IllegalArgumentException |
非法参数 |
RuntimeException |
业务异常(保留原行为) |
Exception |
服务器内部错误(兜底,打印完整堆栈) |
涉及文件:GlobalExceptionHandler.java
6. SchedulingConfig 定时任务线程池
问题:@Scheduled 默认使用单线程执行器,多个定时任务会互相阻塞。
步骤:
- 配置
ThreadPoolTaskSchedulerBean - 设置
poolSize=5、优雅关闭(awaitTerminationSeconds=30) - 添加
ErrorHandler兜底日志,避免异常被吞掉
涉及文件:SchedulingConfig.java
7. CORS 配置抽取
问题:允许的前端来源硬编码在 SecurityConfig.java 中,修改需要重新编译。
步骤:
application.yml新增cors.allowed-origins配置项,支持环境变量CORS_ALLOWED_ORIGINS覆盖SecurityConfig通过@Value注入,split(",")解析为列表
涉及文件:SecurityConfig.java、application.yml
三、涉及文件清单
| 文件 | 操作 | 说明 |
|---|---|---|
service/SummaryConsumer.java |
修改 | 构造器注入、CacheCleaner、公共常量 |
service/impl/CommentServiceImpl.java |
重写 | 构造器注入、修复deleteComment、缓存、MQ通知 |
config/CacheWarmup.java |
修改 | 构造器注入、公共常量 |
service/CommentNotifyConsumer.java |
修改 | 构造器注入、幂等性检查 |
common/exception/GlobalExceptionHandler.java |
修改 | 细粒度异常处理 |
config/SchedulingConfig.java |
修改 | 定时任务线程池 |
config/SecurityConfig.java |
修改 | CORS配置抽取到yml |
resources/application.yml |
修改 | 新增cors配置 |
四、总结
- 依赖注入规范化:所有文件统一使用
@RequiredArgsConstructor构造器注入,消除@Autowired字段注入 - 代码复用:
CacheCleaner统一缓存清理,BlogCacheConstants统一常量引用 - Bug 修复:
deleteComment子回复删除逻辑从错误修复为正确查找 - 功能增强:评论添加 Redis 缓存 + RabbitMQ 异步通知作者
- 可靠性:评论通知消费者添加幂等性检查,防止重复消费
- 异常治理:全局异常处理细化到具体异常类型,区分可预知和不可预知异常
- 基础设施:定时任务专用线程池,优雅关闭 + 异常兜底日志
- 配置外置:CORS allowed origins 从代码硬编码改为配置文件 + 环境变量