Docker Compose通信故障排障实战：深入分析容器日志与网络配置
当Docker Compose中的服务无法相互通信时，系统性的排查是关键。日志和网络设置是两个最重要的切入点。通过仔细分析日志可以了解应用层面的错误，而检查网络配置则能确认底层连接是否正常。
一、 排查容器日志
容器日志是排错的第一手资料，它能揭示应用启动失败、连接被拒、认证错误等详细信息。
1. 查看目标服务日志 (检查服务是否正常启动)
这是首要步骤。如果目标服务（例如数据库db）本身没有正常运行，通信必然失败。
- 命令:
docker compose logs <service_name>
- 示例:
docker compose logs db (查看名为db的服务日志)
- 关注点:
- 是否有启动错误信息（如配置错误、端口被占用、权限问题）？
- 是否成功监听在预期的端口上？
- 是否有来自客户端的连接尝试记录？
- 是否有认证失败的记录？
2. 查看客户端服务日志 (检查客户端的错误信息)
客户端服务（例如应用web）的日志会告诉你它尝试连接时遇到了什么问题。
- 命令:
docker compose logs <client_service_name>
- 示例:
docker compose logs web (查看名为web的服务日志)
- 关注点:
- 是否有“host not found”、“name or service not known”等DNS解析失败的错误？这通常指向网络或服务名问题。
- 是否有“connection refused”错误？这表示服务名解析成功，但目标端口没有服务在监听，或者目标服务未就绪。
- 是否有连接超时错误？这可能意味着网络延迟、防火墙阻拦或服务响应慢。
- 是否有认证失败信息？这可能意味着环境变量配置错误。
3. 实时追踪日志
使用-f参数可以实时追踪日志输出，这对于观察服务启动过程或重现问题非常有用。
- 命令:
docker compose logs -f <service_name>
二、 排查网络设置
如果日志没有明确指出应用错误，下一步就是检查Docker的网络配置。
1. 确认服务连接的网络
检查Compose应用创建了哪些网络，以及每个服务都连接到了哪些网络。
- 查看应用网络:
docker compose config --services 可以列出服务名，docker compose config (不带参数) 可以输出整个配置，包括网络定义。或者直接查看docker-compose.yml文件。
- 查看Docker网络列表:
docker network ls 查看所有Docker网络，找到与你的Compose项目相关的网络（通常命名格式为<project_name>_default或自定义名称）。
- 检查特定网络详情:
docker network inspect <network_name> 会显示该网络的详细信息，包括连接到此网络的容器列表。确认需要通信的容器ID都列在其中。
2. 测试网络连通性 (进入容器内部)
这是最直接的测试方法，可以模拟客户端服务的行为。
- 进入客户端容器:
docker compose exec <client_service_name> sh (或 bash, 取决于容器内安装的shell)。
- DNS解析测试: 在容器内部使用
ping <target_service_name> 或 nslookup <target_service_name>。如果能成功解析到IP地址，说明Docker内部DNS工作正常。
- TCP连接测试: 使用
telnet <target_service_name> <port> 或 nc -zv <target_service_name> <port> 来测试是否能成功连接到目标服务的特定端口。例如，telnet db 5432 (测试连接到名为db的PostgreSQL服务的5432端口)。如果连接成功，说明网络层是通的。
- HTTP请求测试: 如果是HTTP服务，可以使用
curl http://<target_service_name>:<port>/path 来测试。
三、 综合分析
将日志信息和网络检查结果结合起来分析：
- 如果日志显示“host not found”，且
ping也失败，则问题很可能出在网络配置或服务名拼写错误上。 - 如果日志显示“connection refused”，但
telnet能连接成功，那问题可能出在应用层配置（如数据库用户名密码错误）或应用自身的状态上。 - 如果日志显示“connection refused”，且
telnet也失败，那么目标服务可能没有在指定端口监听，或者启动失败。
通过这种“先看日志，再查网络，最后进容器验证”的系统性方法，可以高效地定位并解决Docker Compose服务间的通信问题。
