必须完成驱动安装、连接配置、服务初始化和缓存逻辑嵌入四环节：①执行pip install redis安装客户端；②在config/database.py中正确定义REDIS_CONFIG；③于app.py中按序导入、实例化并挂载redis_client；④在路由中实现“先查Redis缓存，未命中则查MySQL并回填”。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Qoder框架中正确集成Redis实现缓存能力，必须完成驱动安装、连接配置、服务初始化和缓存逻辑嵌入四个环节，缺一不可，否则路由层无法执行“先查缓存后查库”的策略。
安装Redis客户端驱动
Qoder不自带Redis连接能力，需显式安装Python版redis客户端。仅安装PyMySQL无法让Redis生效，二者驱动完全独立。
执行命令安装redis驱动：pip install redis
⚠️ 注意：不要执行 pip installredis（中间无空格），该命令会报错并安装一个不存在的包。已验证有效的命令必须带空格。
安装完成后运行校验：python -c "import redis; print('✅ Redis driver loaded')"，输出成功提示才算完成。
配置Redis连接参数
所有数据库配置统一收口在 config/database.py 文件中，Redis配置块必须命名为 【REDIS_CONFIG】，否则Qoder初始化时无法识别。
在该文件末尾添加如下字典：
REDIS_CONFIG = {<br> "host": "127.0.0.1",<br> "port": 6379,<br> "db": 0,<br> "password": "your_redis_password",<br> "decode_responses": True<br>}
若Redis未设密码，请将 "password" 值设为 None 或直接删去该键；设为空字符串 "" 将导致认证失败。
初始化Redis实例并挂载到应用
打开 app.py，在创建Qoder实例后、启动前插入初始化逻辑：
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
第一步：导入模块 —— from config.database import REDIS_CONFIG
第二步：实例化客户端 —— redis_client = redis.Redis(**REDIS_CONFIG)
第三步：挂载为全局属性 —— app.redis = redis_client
这三步必须严格按顺序执行，且不能放在路由定义之后，否则后续视图函数中调用 app.redis 会抛出 AttributeError。
在路由中启用缓存读写逻辑
方法一：手动控制缓存生命周期
在具体路由函数内，先拼接缓存键，再调用 get → 判空 → setex：
cache_key = f"user:profile:{user_id}"<br>cached = app.redis.get(cache_key)<br>if cached:<br> return json.loads(cached)<br>data = fetch_from_mysql(user_id) # 实际查库逻辑<br>app.redis.setex(cache_key, 300, json.dumps(data)) # 5分钟过期<br>return data
方法二：使用Qoder内置缓存装饰器（需Qoder ≥ v2.4.0）
在路由函数上方添加：@cache(ttl=300, key_func=lambda req: f"search:{req.query_params.get('q')}")
该装饰器自动处理键生成、命中判断与回填，但要求请求对象具备 query_params 属性，否则运行时报错。
