基于Docker Compose部署多服务时Spring Boot无法连接Redis
修复方案
核心问题定位
- 应用连接配置错误:日志显示Jedis尝试连接
localhost:6389,容器网络隔离机制下,应用容器内的localhost指向应用自身,而非Redis容器;且端口与Redis服务实际监听的6379不匹配。 - 网络配置冗余:Docker Compose v3+默认会为同项目下的所有服务创建自定义bridge网络,内置DNS可直接通过服务名做主机名解析,原有
links配置属于已废弃特性,无需额外配置。
具体修复步骤
1. 调整Spring Boot Redis连接配置
将配置文件(如application.properties/application.yml)中的Redis连接参数改为Docker Compose内的服务标识:
spring.redis.host=redis spring.redis.port=6379
如果不想硬编码配置,可在Docker Compose的web服务中通过环境变量覆盖默认配置,适配本地、容器多环境部署需求:
web: build: . ports: - "9080:9080" environment: SPRING_REDIS_HOST: redis SPRING_REDIS_PORT: 6379
2. 精简Docker Compose配置
删除web服务下已废弃的links配置,无需额外声明服务依赖,同一项目下的服务自动加入同一网络,修改后的完整docker-compose.yml参考:
version: '3' services: web: build: . ports: - "9080:9080" environment: SPRING_REDIS_HOST: redis SPRING_REDIS_PORT: 6379 redis: image: redis ports: - "6379:6379" zookeeper: image: wurstmeister/zookeeper ports: - "2181:2181" kafka: build: . ports: - "9092" environment: KAFKA_ADVERTISED_HOST_NAME: 192.168.99.100 KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181 volumes: - /var/run/docker.sock:/var/run/docker.sock
3. 重启服务验证连通性
- 先执行
docker-compose down清除旧容器、旧网络残留,避免之前的缓存配置生效。 - 执行
docker-compose up -d重新启动所有服务。 - 若仍有异常,可进入web容器手动测试连通性:
- 执行
docker exec -it simtuitive-core-backend_web_1 sh进入容器 - 执行
nc -zv redis 6379,返回连接成功说明网络链路正常
- 执行
补充注意:不要在容器内使用
localhost访问其他组件,所有跨容器服务访问都使用Docker Compose内的服务名作为主机名即可。
内容的提问来源于stack exchange,提问作者Sanjeevi Kumaran
相关产品推荐
相关产品推荐

