FastAPI中asyncio_redis部署Docker后连接异常求助

核心原因排查 #

1. asyncio_redis已废弃：该库多年未维护，与新版Python、asyncio存在兼容性问题，连接池创建逻辑可能触发无响应阻塞。
2. Docker网络寻址错误：虽然能通过PING确认Redis服务存活，但创建连接池时若使用localhost（容器内localhost与宿主机/Redis容器的网络空间不互通），会导致实际连接失败却无报错阻塞。
3. 事件循环调度异常：FastAPI默认的uvicorn事件循环与asyncio_redis的旧逻辑存在冲突，导致await调用无法正常执行。

分步解决方案 #

1. 替换为维护中的异步Redis库（优先推荐） #

asyncio_redis已停止更新，直接换用redis-py的异步分支：

• 卸载旧库：

  pip uninstall asyncio_redis -y
  

• 安装新版redis：

  pip install redis>=4.0
  

• 修改代码中的Redis连接逻辑：

  import redis.asyncio as redis
  
  # 初始化连接池（使用Redis容器的别名，例如redis）
  redis_pool = redis.ConnectionPool.from_url("redis://redis:6379")
  redis_client = redis.Redis(connection_pool=redis_pool)
  
  # 示例路由
  @app.get("/redis-test")
  async def test_redis():
      await redis_client.set("test_key", "hello_docker")
      result = await redis_client.get("test_key")
      return {"result": result.decode()}
  

2. 修正Docker网络配置 #

• 创建共享网络，让FastAPI和Redis容器互通：

  docker network create app-net
  

• 启动Redis容器时加入网络：

  docker run -d --name redis --network app-net redis:latest
  

• 启动FastAPI容器时加入同一网络，确保代码中Redis地址用容器名redis而非localhost：

  docker run -d --name fastapi-app --network app-net -p 8000:8000 your-fastapi-image
  

3. 调试旧库的连接超时（临时方案） #

若必须保留asyncio_redis，给连接池创建加超时检测，定位阻塞原因：

import asyncio
import asyncio_redis

async def init_redis():
    try:
        # 设置10秒超时
        pool = await asyncio.wait_for(
            asyncio_redis.Pool.create(host="redis", port=6379, poolsize=5),
            timeout=10
        )
        print("test2")
        return pool
    except asyncio.TimeoutError:
        print("连接池创建超时，检查Redis地址和网络配置")
    except Exception as e:
        print(f"连接错误：{str(e)}")

4. 确认事件循环启动方式 #

使用uvicorn启动FastAPI时，确保单worker（多worker会导致异步资源共享问题）：

uvicorn main:app --host 0.0.0.0 --port 8000 --workers 1

内容的提问来源于stack exchange，提问作者Jimmy Hanns