HotKey Platform — 热Key检测平台

《HotKey Platform — 热Key检测平台》这篇在博客园热度很高，讲的正是大家天天碰到的事。下面帮你把要点捋出来，结尾有能直接抄的结论。

从架构设计到模块解析，从数据流转到上手使用，一文讲透热Key检测平台的完整实现。 目录 一、项目背景与定位 二、系统架构总览 三、技术选型 四、项目模块结构 五、数据流转全链路 六、SDK 模块深度解析 七、Server 服务端深度解析 八、数据库设计 九、控制台与可视化 十、完整使用指南 十一、关键设计决策与性能分析 十二、总结与展望 一、项目背景与定位 1.1 什么是热Key？ 在高并发的业务场景中，某些数据（如秒杀商品ID、热门课程ID、爆款商品SKU）会在短时间内被大量请求反复访问。这些被高频命中的数据就是所谓的 热Key 。

从架构设计到模块解析，从数据流转到上手使用，一文讲透热Key检测平台的完整实现。 目录 一、项目背景与定位 二、系统架构总览 三、技术选型 四、项目模块结构 五、数据流转全链路 六、SDK 模块深度解析 七、Server 服务端深度解析 八、数据库设计 九、控制台与可视化 十、完整使用指南 十一、关键设计决策与性能分析 十二、总结与展望 一、项目背景与定位 1.1 什么是热Key？ 在高并发的业务场景中，某些数据（如秒杀商品ID、热门课程ID、爆款商品SKU）会在短时间内被大量请求反复访问。这些被高频命中的数据就是所谓的 热Key 。 热Key的危害不容小觑： 数据库压力集中 ：大量请求打到同一行数据，导致数据库连接池耗尽 缓存击穿 ：热Key过期瞬间，海量请求穿透到数据库 资源倾斜 ：单机/单节点承载过多请求，集群负载均衡失效 1.2 HotKey Platform 做了什么？

从架构设计到模块解析，从数据流转到上手使用，一文讲透热Key检测平台的完整实现。 目录 一、项目背景与定位 二、系统架构总览 三、技术选型 四、项目模块结构 五、数据流转全链路 六、SDK 模块深度解析 七、Server 服务端深度解析 八、数据库设计 九、控制台与可视化 十、完整使用指南 十一、关键设计决策与性能分析 十二、总结与展望 一、项目背景与定位 1.1 什么是热Key？ 在高并发的业务场景中，某些数据（如秒杀商品ID、热门课程ID、爆款商品SKU）会在短时间内被大量请求反复访问。这些被高频命中的数据就是所谓的 热Key 。 热Key的危害不容小觑： 数据库压力集中 ：大量请求打到同一行数据，导致数据库连接池耗尽 缓存击穿 ：热Key过期瞬间，海量请求穿透到数据库 资源倾斜 ：单机/单节点承载过多请求，集群负载均衡失效 1.2 HotKey Platform 做了什么？ HotKey Platform 是一个 实时热Key检测与可视化平台 ，核心能力包括： 能力 说明 无侵入采集 通过注解 + AOP 零侵入地拦截业务方法调用 高性能聚合 双缓冲 Map + LongAdder 实现业务线程零阻塞 滑动窗口检测 基于 Redis ZSet + Lua 脚本实现精确的滑动窗口计数 自动发现注册 业务系统启动时自动向平台注册应用和规则 可视化控制台 仪表盘、趋势图、Top10 排行、QPS 实时监控 生命周期管理 热Key自动冷却、过期记录自动清理 二、系统架构总览 2.1 三大角色 [代码示例略] 角色 部署位置 职责 hotkey-spring-boot-starter （SDK） 嵌入业务系统 JVM 拦截方法调用、采集 Key、批量上报到 Redis Redis 独立中间件 高速数据中转站，接收 SDK 上报的访问计数，供服务端扫描 hotkey-server （服务端） 独立服务（端口 8089） 定时扫描 Redis、判定热Key、持久化到 MySQL、提供控制台 API 2.2 架构全景图 [代码示例略] 三、技术选型 技术 版本 用途 Java 17 开发语言 Spring Boot 3.5.3 应用框架 MyBatis-Plus 3.5.17 ORM 持久层 Spring AOP — 方法拦截与注解增强 Spring SpEL — 动态表达式解析提取 Key 值 Redis (Lettuce) — 高速数据中转 + Lua 原子操作 MySQL 5.7+ / 8.0 热Key记录与统计数据持久化 Maven 3.8+ 多模块构建与依赖管理 ECharts — 前端可视化图表 四、项目模块结构 [代码示例略] 五、数据流转全链路 一条热Key从产生到最终冷却，经历以下 8 个阶段 ： [代码示例略] 完整数据流图： [代码示例略] 六、SDK 模块深度解析 SDK 模块（ hotkey-spring-boot-starter ）是整个系统的入口，嵌入在业务系统 JVM 中运行。

从架构设计到模块解析，从数据流转到上手使用，一文讲透热Key检测平台的完整实现。 目录 一、项目背景与定位 二、系统架构总览 三、技术选型 四、项目模块结构 五、数据流转全链路 六、SDK 模块深度解析 七、Server 服务端深度解析 八、数据库设计 九、控制台与可视化 十、完整使用指南 十一、关键设计决策与性能分析 十二、总结与展望 一、项目背景与定位 1.1 什么是热Key？ 在高并发的业务场景中，某些数据（如秒杀商品ID、热门课程ID、爆款商品SKU）会在短时间内被大量请求反复访问。这些被高频命中的数据就是所谓的 热Key 。 热Key的危害不容小觑： 数据库压力集中 ：大量请求打到同一行数据，导致数据库连接池耗尽 缓存击穿 ：热Key过期瞬间，海量请求穿透到数据库 资源倾斜 ：单机/单节点承载过多请求，集群负载均衡失效 1.2 HotKey Platform 做了什么？ HotKey Platform 是一个 实时热Key检测与可视化平台 ，核心能力包括： 能力 说明 无侵入采集 通过注解 + AOP 零侵入地拦截业务方法调用 高性能聚合 双缓冲 Map + LongAdder 实现业务线程零阻塞 滑动窗口检测 基于 Redis ZSet + Lua 脚本实现精确的滑动窗口计数 自动发现注册 业务系统启动时自动向平台注册应用和规则 可视化控制台 仪表盘、趋势图、Top10 排行、QPS 实时监控 生命周期管理 热Key自动冷却、过期记录自动清理 二、系统架构总览 2.1 三大角色 [代码示例略] 角色 部署位置 职责 hotkey-spring-boot-starter （SDK） 嵌入业务系统 JVM 拦截方法调用、采集 Key、批量上报到 Redis Redis 独立中间件 高速数据中转站，接收 SDK 上报的访问计数，供服务端扫描 hotkey-server （服务端） 独立服务（端口 8089） 定时扫描 Redis、判定热Key、持久化到 MySQL、提供控制台 API 2.2 架构全景图 [代码示例略] 三、技术选型 技术 版本 用途 Java 17 开发语言 Spring Boot 3.5.3 应用框架 MyBatis-Plus 3.5.17 ORM 持久层 Spring AOP — 方法拦截与注解增强 Spring SpEL — 动态表达式解析提取 Key 值 Redis (Lettuce) — 高速数据中转 + Lua 原子操作 MySQL 5.7+ / 8.0 热Key记录与统计数据持久化 Maven 3.8+ 多模块构建与依赖管理 ECharts — 前端可视化图表 四、项目模块结构 [代码示例略] 五、数据流转全链路 一条热Key从产生到最终冷却，经历以下 8 个阶段 ： [代码示例略] 完整数据流图： [代码示例略] 六、SDK 模块深度解析 SDK 模块（ hotkey-spring-boot-starter ）是整个系统的入口，嵌入在业务系统 JVM 中运行。它负责拦截方法调用、提取 Key 值、本地聚合、批量上报到 Redis。

从架构设计到模块解析，从数据流转到上手使用，一文讲透热Key检测平台的完整实现。 目录 一、项目背景与定位 二、系统架构总览 三、技术选型 四、项目模块结构 五、数据流转全链路 六、SDK 模块深度解析 七、Server 服务端深度解析 八、数据库设计 九、控制台与可视化 十、完整使用指南 十一、关键设计决策与性能分析 十二、总结与展望 一、项目背景与定位 1.1 什么是热Key？ 在高并发的业务场景中，某些数据（如秒杀商品ID、热门课程ID、爆款商品SKU）会在短时间内被大量请求反复访问。这些被高频命中的数据就是所谓的 热Key 。 热Key的危害不容小觑： 数据库压力集中 ：大量请求打到同一行数据，导致数据库连接池耗尽 缓存击穿 ：热Key过期瞬间，海量请求穿透到数据库 资源倾斜 ：单机/单节点承载过多请求，集群负载均衡失效 1.2 HotKey Platform 做了什么？ HotKey Platform 是一个 实时热Key检测与可视化平台 ，核心能力包括： 能力 说明 无侵入采集 通过注解 + AOP 零侵入地拦截业务方法调用 高性能聚合 双缓冲 Map + LongAdder 实现业务线程零阻塞 滑动窗口检测 基于 Redis ZSet + Lua 脚本实现精确的滑动窗口计数 自动发现注册 业务系统启动时自动向平台注册应用和规则 可视化控制台 仪表盘、趋势图、Top10 排行、QPS 实时监控 生命周期管理 热Key自动冷却、过期记录自动清理 二、系统架构总览 2.1 三大角色 [代码示例略] 角色 部署位置 职责 hotkey-spring-boot-starter （SDK） 嵌入业务系统 JVM 拦截方法调用、采集 Key、批量上报到 Redis Redis 独立中间件 高速数据中转站，接收 SDK 上报的访问计数，供服务端扫描 hotkey-server （服务端） 独立服务（端口 8089） 定时扫描 Redis、判定热Key、持久化到 MySQL、提供控制台 API 2.2 架构全景图 [代码示例略] 三、技术选型 技术 版本 用途 Java 17 开发语言 Spring Boot 3.5.3 应用框架 MyBatis-Plus 3.5.17 ORM 持久层 Spring AOP — 方法拦截与注解增强 Spring SpEL — 动态表达式解析提取 Key 值 Redis (Lettuce) — 高速数据中转 + Lua 原子操作 MySQL 5.7+ / 8.0 热Key记录与统计数据持久化 Maven 3.8+ 多模块构建与依赖管理 ECharts — 前端可视化图表 四、项目模块结构 [代码示例略] 五、数据流转全链路 一条热Key从产生到最终冷却，经历以下 8 个阶段 ： [代码示例略] 完整数据流图： [代码示例略] 六、SDK 模块深度解析 SDK 模块（ hotkey-spring-boot-starter ）是整个系统的入口，嵌入在业务系统 JVM 中运行。它负责拦截方法调用、提取 Key 值、本地聚合、批量上报到 Redis。 6.1 @HotKey 注解 — 声明式监控入口 [代码示例略] 使用示例： [代码示例略] 设计要点： 注解标注在 ElementType.METHOD 上，保留策略为 RUNTIME ，确保 AOP 能在运行时通过反射读取 rule 属性将方法调用与规则配置绑定，一个规则可以对应多个方法 key 属性使用 SpEL 表达式，支持从任意参数名、嵌套属性中提取值 6.2 HotKeyAspect — AOP 切面拦截 当业务方法被调用时，Spring AOP 的 @Around 通知拦截执行流程： [代码示例略] 关键设计原则： 零侵入 ：采集逻辑包裹在 try-catch 中，任何异常只打 warn 日志，不影响业务方法执行 先采集后执行 ：在 joinPoint.proceed() 之前采集，确保即使方法抛异常也能记录本次调用 异步无阻塞 ： collector.collect() 仅写入内存 Map，耗时为 O(1) 6.3 SpEL 表达式解析 SpEL 解析过程将注解中的表达式（如 "#id" ）结合方法实际参数，计算出具体的 Key 值： [代码示例略] 支持的 SpEL 表达式示例： 表达式 说明 示例值 #id 直接取参数值 "42" #name 取字符串参数 "张三" #user.id 取对象嵌套属性 "100" #request.getHeader('X-Id') 调用方法 "abc" 注意 ：Maven 编译时必须开启 <parameters>true</parameters> ，否则运行时无法获取参数名。

建议先收藏再实操：挑其中一个点今天就试试，跑通了再看下一个。知识只有过手才是你的，你准备先试哪一点？ 来源｜博客园《HotKey Platform — 热Key检测平台》，https://www.cnblogs.com/sun-10387834/p/22981404.html