python创建redis连接池

一、结合fastapi的异步使用

1.整体流程

复制代码

# 1. 导入所有依赖包 (import fastapi, import redis.asyncio...)

# 2. 配置Redis常量 (REDIS_HOST/REDIS_PORT/密码...)

# 3. 创建Redis连接池 → redis_pool = redis.ConnectionPool(...)

# 4. 创建全局Redis客户端 → redis_client = redis.Redis(...)

# 5. 创建FastAPI实例 → app = FastAPI(...)

# 6. 你的这两段生命周期代码，就写在这里

# 7. 写你的所有接口路由 (@app.get/ @app.post...)

2.创建redis客户端

复制代码

# ========== 注意：异步导入的是 redis.asyncio ==========
import redis.asyncio as redis

# Redis 配置和同步完全一致，无需修改
REDIS_HOST = "127.0.0.1"
REDIS_PORT = 6379
REDIS_PASSWORD = ""
REDIS_DB = 0
REDIS_ENCODING = "utf-8"

# 1. 创建【异步】Redis 连接池
redis_pool = redis.ConnectionPool(
    host=REDIS_HOST,
    port=REDIS_PORT,
    password=REDIS_PASSWORD,
    db=REDIS_DB,
    encoding=REDIS_ENCODING,
    decode_responses=True  # 同样自动转字符串，必备配置
)

# 2. 创建全局的【异步】Redis 客户端
redis_client = redis.Redis(connection_pool=redis_pool)

print(redis_client)


from fastapi import FastAPI
# ========== 注意：异步导入的是 redis.asyncio ==========
import redis.asyncio as redis

# Redis 配置和同步完全一致，无需修改
REDIS_HOST = "127.0.0.1"
REDIS_PORT = 6379
REDIS_PASSWORD = ""
REDIS_DB = 0
REDIS_ENCODING = "utf-8"

# 1. 创建【异步】Redis 连接池
redis_pool = redis.ConnectionPool(
    host=REDIS_HOST,
    port=REDIS_PORT,
    password=REDIS_PASSWORD,
    db=REDIS_DB,
    encoding=REDIS_ENCODING,
    decode_responses=True  # 同样自动转字符串，必备配置
)

# 2. 创建全局的【异步】Redis 客户端
redis_client = redis.Redis(connection_pool=redis_pool)

# 初始化 FastAPI 实例
app = FastAPI(title="FastAPI Redis 异步操作示例（推荐）")

3.生命周期定义

复制代码

# @app.on_event("startup") 启动事件函数

# 触发时机：你的 FastAPI 项目刚启动的一瞬间
# （执行 uvicorn main:app --reload 后，项目加载完成的那一刻），这个函数会自动执行一次，只执行一次。


# @app.on_event("shutdown") 关闭事件函数
# 触发时机：你的 FastAPI 项目被手动关闭的一瞬间
# （比如停止服务、服务器重启 / 关机、项目部署重启），这个函数会自动执行一次。

# ========== 异步 Redis 生命周期 ==========

#如果没有这个 ping() 检测，你的项目启动时不会报错，客户端也确实初始化好了，
但是当用户第一次调用 /redis/set 接口时，才会发起第一次真实连接，
如果此时 Redis 配置错了 / 服务没开，接口会直接报错 500，用户体验极差

@app.on_event("startup")
async def startup_event():
    """项目启动时，检查 Redis 连接"""
    try:
        await redis_client.ping()
        print("✅ Redis 异步连接成功！")
    except Exception as e:
        print(f"❌ Redis 异步连接失败：{e}")
        raise e

@app.on_event("shutdown")
async def shutdown_event():
    """项目关闭时，关闭 Redis 连接池"""
    await redis_client.close()
    print("✅ Redis 连接池已优雅关闭")