2026-04-29-21-51-19 - 全栈系统改造：FastAPI后端+SAM2+PostgreSQL+Redis+MinIO+前端Zustand重构

backend/redis_client.py

@@ -0,0 +1,61 @@
+"""Redis client wrapper for caching and task queuing."""
+
+import json
+import logging
+from typing import Optional, Any
+
+import redis
+
+from config import settings
+
+logger = logging.getLogger(__name__)
+
+_redis_client: Optional[redis.Redis] = None
+
+
+def get_redis_client() -> redis.Redis:
+    """Return a singleton Redis client instance."""
+    global _redis_client
+    if _redis_client is None:
+        _redis_client = redis.from_url(settings.redis_url, decode_responses=True)
+    return _redis_client
+
+
+def ping() -> bool:
+    """Check Redis connectivity."""
+    try:
+        return get_redis_client().ping()
+    except redis.ConnectionError as exc:
+        logger.error("Redis ping failed: %s", exc)
+        return False
+
+
+def set_json(key: str, value: Any, expire: Optional[int] = None) -> None:
+    """Store a JSON-serializable value in Redis."""
+    client = get_redis_client()
+    try:
+        client.set(key, json.dumps(value), ex=expire)
+    except redis.RedisError as exc:
+        logger.error("Redis set_json failed: %s", exc)
+        raise
+
+
+def get_json(key: str) -> Optional[Any]:
+    """Retrieve and deserialize a JSON value from Redis."""
+    client = get_redis_client()
+    try:
+        data = client.get(key)
+        return json.loads(data) if data is not None else None
+    except redis.RedisError as exc:
+        logger.error("Redis get_json failed: %s", exc)
+        raise
+
+
+def delete_key(key: str) -> int:
+    """Delete a key from Redis. Returns number of deleted keys."""
+    client = get_redis_client()
+    try:
+        return client.delete(key)
+    except redis.RedisError as exc:
+        logger.error("Redis delete_key failed: %s", exc)
+        raise