Docker Compose部署FastAPI应用无法连接Redis服务求助

1. 彻查连接字符串的实际生效位置 #

• 检查代码中所有初始化Redis连接的逻辑，排查是否存在未更新的配置：
  • 是否有环境变量（比如REDIS_URL）被设置为redis://localhost:6379，且代码优先读取环境变量而非硬编码值？
  • 是否存在多个Redis初始化入口，仅修改了其中一处，其他地方仍用localhost？
  • 检查项目配置文件（如.env、config.py），确认没有遗留localhost相关的Redis地址配置。

2. 验证镜像内的代码是否真的更新 #

• 进入app容器查看代码文件，确认修改已生效：

  docker exec -it meow_chat bash
  # 替换为你的Redis连接代码路径，比如cat app/redis_config.py
  cat 你的代码文件路径
  

  如果文件还是旧内容，说明镜像构建有问题：
  • 检查Dockerfile是否正确复制了最新代码目录；
  • 用docker build --no-cache强制跳过缓存，重新构建镜像。

3. 确认Redis初始化函数被正确调用 #

• 检查FastAPI的启动事件是否执行了init_redis_pool函数，比如：

  from fastapi import FastAPI
  
  app = FastAPI()
  
  @app.on_event("startup")
  async def startup():
      await init_redis_pool()  # 必须确保这个函数被触发
  

  如果该函数未执行，redis_pool会保持None，后续代码可能默认使用localhost连接。

4. 检查Redis服务的监听配置（兜底排查） #

• 进入Redis容器，验证Redis是否允许外部容器连接：

  docker exec -it my-redis redis-cli CONFIG GET bind
  

  如果返回127.0.0.1，说明Redis仅允许本地连接，需在docker-compose.yml中修改Redis启动命令：

  redis_db:
    # 其他配置不变
    command: redis-server --bind 0.0.0.0
  

  注：默认Redis镜像已绑定0.0.0.0，此步骤仅作兜底验证。

5. 在app容器内直接测试Redis连接 #

• 用redis-cli直接连接redis_db服务，确认网络连通性：

  docker exec -it meow_chat redis-cli -h redis_db
  

  如果执行PING能返回PONG，说明网络无问题，故障肯定出在应用代码的连接配置上。

内容的提问来源于stack exchange，提问作者Jerry Chuang