From 86d580edd8753c7375eebb2bc81799fd2441f1bf Mon Sep 17 00:00:00 2001
From: Wu Clan <jianhengwu0407@gmail.com>
Date: Tue, 4 Nov 2025 20:59:45 +0800
Subject: [PATCH] Optimize redis batch get and delete operations (#899)

* Optimize redis batch get and delete operations

* Fix typo
---
 backend/app/admin/api/v1/monitor/online.py |  2 +-
 backend/app/admin/service/auth_service.py  |  2 +-
 backend/database/redis.py                  | 40 ++++++++++++++--------
 3 files changed, 28 insertions(+), 16 deletions(-)

diff --git a/backend/app/admin/api/v1/monitor/online.py b/backend/app/admin/api/v1/monitor/online.py
index 999cf693..5edfe5bc 100644
--- a/backend/app/admin/api/v1/monitor/online.py
+++ b/backend/app/admin/api/v1/monitor/online.py
@@ -18,7 +18,7 @@ router = APIRouter()
 async def get_sessions(
     username: Annotated[str | None, Query(description='用户名')] = None,
 ) -> ResponseSchemaModel[list[GetTokenDetail]]:
-    token_keys = await redis_client.keys(f'{settings.TOKEN_REDIS_PREFIX}:*')
+    token_keys = await redis_client.get_prefix(f'{settings.TOKEN_REDIS_PREFIX}:*')
     online_clients = await redis_client.smembers(settings.TOKEN_ONLINE_REDIS_PREFIX)
     data: list[GetTokenDetail] = []
 
diff --git a/backend/app/admin/service/auth_service.py b/backend/app/admin/service/auth_service.py
index 7fba7f0b..e6afd430 100644
--- a/backend/app/admin/service/auth_service.py
+++ b/backend/app/admin/service/auth_service.py
@@ -208,7 +208,7 @@ class AuthService:
             raise errors.NotFoundError(msg='用户不存在')
         if not user.status:
             raise errors.AuthorizationError(msg='用户已被锁定, 请联系统管理员')
-        if not user.is_multi_login and await redis_client.keys(match=f'{settings.TOKEN_REDIS_PREFIX}:{user.id}:*'):
+        if not user.is_multi_login and await redis_client.get_prefix(f'{settings.TOKEN_REDIS_PREFIX}:{user.id}:*'):
             raise errors.ForbiddenError(msg='此用户已在异地登录，请重新登录并及时修改密码')
         new_token = await create_new_token(
             refresh_token,
diff --git a/backend/database/redis.py b/backend/database/redis.py
index 1723e2e6..4f8759f3 100644
--- a/backend/database/redis.py
+++ b/backend/database/redis.py
@@ -38,26 +38,38 @@ class RedisCli(Redis):
             log.error('❌ 数据库 redis 连接异常 {}', e)
             sys.exit()
 
-    async def delete_prefix(self, prefix: str, exclude: str | list[str] | None = None) -> None:
+    async def delete_prefix(self, prefix: str, exclude: str | list[str] | None = None, batch_size: int = 1000) -> None:
         """
         删除指定前缀的所有 key
 
-        :param prefix: 前缀
-        :param exclude: 排除的 key
+        :param prefix: 要删除的键前缀
+        :param exclude: 要排除的键或键列表
+        :param batch_size: 批量删除的大小，避免一次性删除过多键导致 Redis 阻塞
         :return:
         """
-        keys = []
+        exclude_set = set(exclude) if isinstance(exclude, list) else {exclude} if isinstance(exclude, str) else set()
+        batch_keys = []
+
         async for key in self.scan_iter(match=f'{prefix}*'):
-            if isinstance(exclude, str):
-                if key != exclude:
-                    keys.append(key)
-            elif isinstance(exclude, list):
-                if key not in exclude:
-                    keys.append(key)
-            else:
-                keys.append(key)
-        if keys:
-            await self.delete(*keys)
+            if key not in exclude_set:
+                batch_keys.append(key)
+
+                if len(batch_keys) >= batch_size:
+                    await self.delete(*batch_keys)
+                    batch_keys.clear()
+
+        if batch_keys:
+            await self.delete(*batch_keys)
+
+    async def get_prefix(self, prefix: str, count: int = 100) -> list[str]:
+        """
+        获取指定前缀的所有 key
+
+        :param prefix: 要搜索的键前缀
+        :param count: 每次扫描批次的数量，值越大扫描速度越快，但会占用更多服务器资源
+        :return:
+        """
+        return [key async for key in self.scan_iter(match=f'{prefix}*', count=count)]
 
 
 # 创建 redis 客户端单例