现象
doCker compose 起了一个 web 和一个 redis,web 里 ping redis 提示 Name or service not known,连接 redis:6379 也超时,但两个容器都在运行,宿主机上用映射端口访问 redis 又是通的。
原因
compose 默认给项目建一个 bridge 网络,服务之间靠服务名做 DNS 解析。如果两个服务分别写在不同的 compose 文件或不同项目名下,就落在不同网络里;也有人手动指定了 network_mode: host 或 external 网络,服务名自然解析不到。
解决步骤
第一步,确认两个容器是否在同一网络。
docker compose ps
docker network ls
docker inspect -f '{{json .NetworkSettings.Networks}}' web
第二步,统一网络声明。在同一个 compose 文件里定义 services,让它们默认加入同一网络;跨文件时用 external: true 引用同一个已存在的网络,并给每个服务显式写上 networks 列表。
第三步,检查服务名和启动顺序。容器名不等于服务名,连接串里要用 services 下的键;应用启动早于 redis 就绪时会连接失败,加上 depends_on 和健康检查,或在代码里做重试。
验证
进入 web 容器执行 getent hosts redis 能解析出 IP,ping 和 redis-CLI -h redis 都通,应用日志不再报连接超时,说明网络已打通。
小结
compose 内互通依赖同一网络加服务名解析。先 inspect 网络归属,再统一声明,比改 hosts 文件可靠。
