73 行
3.0 KiB
Markdown
73 行
3.0 KiB
Markdown
# fix(user,mp): 轮播图修改后小程序立即生效（修缓存不清导致最长 30min 延迟）
|
||
|
||
> **服务**: hl-user-service + hl-mp-service
|
||
> **PR**: #891
|
||
> **Issue**: #888
|
||
> **Merge commit**: 已合并到 dev
|
||
> **日期**: 2026-04-19
|
||
> **影响范围**: 管理端修改轮播图后小程序实时性
|
||
> **前端是否需要改动**: **无需改动**（后端行为修复，前端原调用继续工作且立即可见新数据）
|
||
|
||
---
|
||
|
||
## 一、背景
|
||
|
||
管理端 `PUT /admin/banner/{id}` 修改轮播图保存成功后，小程序端 `GET /mp/banner/active` 仍返回旧数据，最长 30 分钟才自动更新。
|
||
|
||
**前端影响**：如果之前前端有以下 workaround，**现在可以移除**：
|
||
- 强制刷新页面、二次请求、轮询轮播图接口
|
||
- "保存后等一会儿"的用户提示
|
||
|
||
---
|
||
|
||
## 二、变更接口
|
||
|
||
| # | 接口 | 方法 | 路径 | 变更类型 | 前端改动 |
|
||
|---|------|------|------|---------|---------|
|
||
| 1 | 新建/修改/删除轮播图 | POST/PUT/DELETE | `/admin/banner` `/admin/banner/{id}` | **行为修复**：保存立即生效 | 无需 |
|
||
| 2 | 小程序轮播图列表 | GET | `/mp/banner/active` | 缓存 TTL 由 30min 降到 5min | 无需 |
|
||
|
||
两个接口的请求/响应结构**完全不变**。
|
||
|
||
---
|
||
|
||
## 三、修复说明
|
||
|
||
两层原因叠加导致 bug：
|
||
|
||
1. **代码层**：`BannerService.create/update/delete` 在 `@Transactional` 事务体内调用缓存清理，事务提交前存在时间窗口，并发读请求把旧数据写回 `mp:banner:active` 开启新 30min TTL
|
||
2. **配置层**：测试环境 Nacos 把 `hl-mp-service-test.yml` 的 `redis.database` 配成 `1`，而 user/resource 服务未显式配置（默认 DB 0），跨 DB 导致 `MpCacheEvict` 一直清不到 mp 缓存
|
||
|
||
**已修**：
|
||
- 代码：evict 移到 `TransactionSynchronization.afterCommit()` 回调；TTL 30min → 5min（兜底）
|
||
- 配置：Nacos `hl-mp-service-test.yml` 的 `redis.database: 1` 改为 `0`，与其他服务对齐
|
||
|
||
---
|
||
|
||
## 四、前端行动项
|
||
|
||
**无需任何改动**。清理历史 workaround 的列表：
|
||
|
||
| 可移除的 workaround | 原因 |
|
||
|--------------------|------|
|
||
| 保存轮播图后调用 `refresh()` / 延迟 2 秒重拉 | 后端已立即清缓存 |
|
||
| 本地存储一份"乐观更新"轮播图 | 不再必要 |
|
||
| "请稍后刷新"类 toast 提示 | 可改为"保存成功" |
|
||
|
||
---
|
||
|
||
## 五、测试环境已验证
|
||
|
||
端到端实测（2026-04-19 01:35）：
|
||
|
||
```bash
|
||
# 步骤 1：PUT banner/5 title="嗨冰雪" → code=200
|
||
# 步骤 2：GET /mp/banner/active → "嗨冰雪" ✓
|
||
# 步骤 3：PUT banner/5 title="嗨冰雪(V2验证)" → code=200
|
||
# 步骤 4：GET /mp/banner/active → "嗨冰雪(V2验证)" ✓ 立即生效
|
||
# 步骤 5：PUT 回滚 title="嗨冰雪" → code=200
|
||
# 步骤 6：GET /mp/banner/active → "嗨冰雪" ✓
|
||
```
|
||
|
||
后端团队下一步计划：同类"事务内清缓存 + 跨 DB"隐患还存在于 SysDict/FrontendConfig/Hotel/Activity/Scenic/Restaurant 6 个 Service，将以批量 PR 统一抽 `CacheEvictAfterCommit` 公共工具类解决。前端同样**无需改动**。
|