SYSTEM
Redis基础
src/content/notes/blog-dev/Redis基础.md Redis基础
1.术语速览
| 术语 | 通俗解释 | 类比 |
|---|---|---|
| Redis | 内存型键值数据库,读写速度极快,用来做缓存、分布式锁、计数器等 | 高速缓存仓库 |
| Jedis | Java 操作 Redis 的原生客户端,底层直接发命令 | 手动扳手(基础工具) |
| Lettuce | SpringBoot 2.x + 默认的 Redis 客户端,支持异步、集群、连接池 | 智能电动工具(更省力) |
| RedisTemplate | Spring 对 Redis 客户端的封装,支持所有数据类型、自定义序列化,企业级通用 | 万能工具箱 |
| StringRedisTemplate | RedisTemplate 的子类,专门处理字符串类型,默认序列化更友好 | 字符串专用工具箱 |
| Redis 连接池 | 提前创建好一批 Redis 连接,复用给请求,避免频繁创建销毁连接 | 银行窗口(不用每次开新窗口) |
| 序列化 / 反序列化 | 把 Java 对象转成 Redis 能存的字节(序列化),再读出来转回对象(反序列化) | 打包 / 拆快递 |
| 分布式锁 | 用 Redis 控制多个服务 / 请求互斥执行同一操作,防止重复提交、并发问题 | 公共卫生间的门锁 |
| Lua 脚本 | 在 Redis 里执行的脚本,用来保证多个命令的原子性(要么全成功要么全失败) | 一次性执行的 “组合拳” 指令 |
| 过期时间(expire) | 给 Redis 的 key 设置自动删除时间,防止数据一直占内存 | 超市食品的保质期 |
| 缓存穿透 | 请求查不存在的数据,一直打到数据库,压垮 DB | 有人反复问不存在的快递单号 |
| 缓存击穿 | 热点 key 过期瞬间,大量请求打到数据库 | 热门景点门票突然售罄,游客全挤到售票窗口 |
| 缓存雪崩 | 大量 key 同时过期,所有请求瞬间压垮数据库 | 所有航班同时取消,旅客全挤到柜台 |
| @Cacheable | Spring 缓存注解,方法结果自动存 Redis,下次调用直接读缓存 | 常用知识点抄到小抄上 |
| @CacheEvict | Spring 缓存注解,删除 Redis 里的缓存数据 | 擦掉过时的小抄 |
二、Java 原生环境操作 Redis(Jedis)
链接🔗:https://blog.csdn.net/weixin_52741870/article/details/157426069
https://blog.csdn.net/2503_92145588/article/details/148574225
给文章列表添加分页查询,替换全量 findAll
项目改造任务:
1:blog/src/main/java/com/blog/blog/entity/Article.java
@Column(name="summary", length=1000) // length 500 → 1000,给 summary 留足空间
private String summary;
2:blog/src/main/java/com/blog/blog/repository/ArticleRepository.java
// 新增:分页查询,按创建时间倒序
Page<Article> findAllByOrderByCreateTimeDesc(Pageable pageable); //该方法在问题一的getAllArticlesPage有使用
3:blog/src/main/java/com/blog/blog/service/ArticleService.java
// 分页查询文章列表(返回 PageResult,避免序列化 PageImpl)
PageResult<Article> getAllArticlesPage(int page, int size);
4:blog/src/main/java/com/blog/blog/service/impl/ArticleServiceImpl.java
@Override
public Article getArticle(Long id) {
String key = ARTICLE_DETAIL_KEY_PREFIX + id;
// 1. 先从 Redis 查
Object cacheObj = redisUtil.get(key);
if (!ObjectUtils.isEmpty(cacheObj)) {
return (Article) cacheObj;
}
// 2. 缓存未命中,从数据库查
Article article = articleRepository.findById(id).orElseThrow(() -> new RuntimeException("文章不存在"));
// 3. 写入 Redis,过期时间 30 分钟
redisUtil.set(key, article, ARTICLE_DETAIL_EXPIRE);
return article;
}
5:blog/src/main/java/com/blog/blog/controller/ArticleController.java
//替换老 list 方法
@GetMapping("/list")
public Result<PageResult<Article>> getAllArticles(
@RequestParam(defaultValue = "0") int page,
@RequestParam(defaultValue = "10") int size) {
PageResult<Article> articles = articleService.getAllArticlesPage(page, size);
return Result.success(articles);
}
问题:
问题一:Serializing PageImpl 警告
现象:HTTP 431。
1.新建 VO 类。新建PageResult.java
@Data
public class PageResult<T> {
private List<T> content; //当前页数据列表
private long totalElements; //总记录数
private int totalPages; //总页数
private int number; //当前页码(从 0 开始)
private int size; //每页大小
private boolean first; //是否是第一页
private boolean last; //是否是最后一页
private boolean hasNext; //是否有下一页
private boolean hasPrevious; //是否有上一页
//从 Spring Data 的 Page 对象构造 PageResult
//手动构造 PageResult(用于缓存命中时)
2.ArticleServiceImpl.java
- 新增分页缓存 key 常量
ARTICLE_LIST_PAGE_KEY
private static final String ARTICLE_LIST_PAGE_KEY = "article:list:page:"; //分页文章数据的前缀
- 修复
getAllArticlesPage()添加缓存读取逻辑
ArticleService返回对象改为 PageResult<Article>,实现层使用 PageResult.of() 构造返回对象
@Override
public PageResult<Article> getAllArticlesPage(int page, int size) {
// 【参数校验】防止前端乱传导致 400
if (page < 0) page = 0;
if (size <= 0) size = 10;
String listKey = ARTICLE_LIST_PAGE_KEY + page;
String totalKey = ARTICLE_TOTAL_COUNT_KEY;
// 1. 先从 Redis 查缓存(同时查列表和总数)
Object cacheObj = redisUtil.get(listKey);
Object totalObj = redisUtil.get(totalKey);
// 2. 缓存命中:列表和总数都存在,直接返回,不查数据库
if (!ObjectUtils.isEmpty(cacheObj) && !ObjectUtils.isEmpty(totalObj)) {
@SuppressWarnings("unchecked")
List<Article> cachedList = (List<Article>) cacheObj;
long total = ((Number) totalObj).longValue();
// 使用缓存的列表和总数构造 PageResult,完全不查数据库
return PageResult.of(cachedList, total, page, size);
}
// 3. 缓存未命中:从数据库查询(排序规则封装在 Repository 方法中)
Pageable pageable = PageRequest.of(page, size);
Page<Article> pageResult = articleRepository.findAllByOrderByCreateTimeDesc(pageable);
// 4. 写入 Redis 缓存
redisUtil.set(listKey, pageResult.getContent(), ARTICLE_LIST_EXPIRE);
redisUtil.set(totalKey, pageResult.getTotalElements(), ARTICLE_TOTAL_EXPIRE);
// 5. 返回 PageResult(而不是 PageImpl)
return PageResult.of(pageResult);
}
- 修改
clearRelatedCaches()删除分页缓存
//删除缓存
private void clearRelatedCaches(Long articleId) {
redisUtil.delete(ARTICLE_LIST_KEY);
// 删除所有分页缓存(使用通配符,需要RedisTemplate支持)
// 由于当前RedisUtil不支持模糊删除,这里删除常用分页缓存
for (int i = 0; i < 10; i++) {
redisUtil.delete(ARTICLE_LIST_PAGE_KEY + i);
}
redisUtil.delete(ARTICLE_DETAIL_KEY_PREFIX + articleId);
redisUtil.delete(ARTICLE_RANKING_VIEWS_KEY);
redisUtil.delete(ARTICLE_RANKING_LATEST_KEY);
redisUtil.delete(ARTICLE_TOTAL_COUNT_KEY); //清除总数缓存
}
3.ArticleController.java
返回类型从 Result<Page<Article>> 改为 Result<PageResult<Article>>
问题二:缓存命中后仍查总数
根因:原代码在缓存命中后仍调用了 articleRepository.findAll(pageable) 获取总数
解决方案:修改ArticleServiceImpl.java的 getAllArticlesPage 方法
Object cacheObj = redisUtil.get(listKey);
if (!ObjectUtils.isEmpty(cacheObj)) {
// 问题:这里还创建了 pageable,会触发 count 查询
Pageable pageable = PageRequest.of(page, size, ...);
return new PageImpl<>(cachedList, pageable, total);
}
// 修改后:同时查列表和总数缓存,完全不查数据库
Object cacheObj = redisUtil.get(listKey);
Object totalObj = redisUtil.get(totalKey);
if (!ObjectUtils.isEmpty(cacheObj) && !ObjectUtils.isEmpty(totalObj)) {
return PageResult.of(cachedList, total, page, size); // ✅ 不查数据库
}
问题三:HTTP 431 问题
部分原因:JWT 拦截器逻辑不完善,OPTIONS 预检请求和部分 GET 请求被拦截
解决方案:修改JwtInterceptor.java
// 新增:放行 OPTIONS 预检请求(跨域)
if ("OPTIONS".equalsIgnoreCase(method)) {
return true;
}
// 完善:放行所有公开的 GET 请求
if ("GET".equalsIgnoreCase(method)) {
if (requestURI.equals("/api/article/list") ||
requestURI.equals("/api/category/list") ||
// ... 其他公开接口
) {
return true;
}
}
现象:文章内容通过 URL 查询参数传递,导致 URL 过长,超过了服务器的请求头大小限制
根本原因:不是 JWT、不是 Redis、不是分页,而是参数传递方式选择不当。
短文本用 URL 参数没问题,但长文本(文章内容)必须用请求体传递。这是一个典型的”前端 API 调用方式错误”导致的问题。
解决方案:修改后端:使用请求体接收参数
// 修复前:@RequestParam 通过 URL 参数接收
@PutMapping("/update/{id}")
public Result<Article> updateArticle(@PathVariable Long id,
@RequestParam String title, @RequestParam String content) {
// 修复后:@RequestBody 通过请求体接收
@PutMapping("/update/{id}")
public Result<Article> updateArticle(@PathVariable Long id,
@RequestBody Article article) {
问题四:文章分类修改失败
根因:后端接口没有接收 categoryId 参数,前端也没有传递。
解决方案:
| ArticleService.java | createArticle和updateArticle方法接口添加 categoryId 参数 |
|---|---|
| ArticleServiceImpl.java | 同上更新逻辑添加 setCategoryId(categoryId) |
| ArticleController.java | 调用 service 时传入 article.getCategoryId() |