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