问题：docker compose Could not resolve host 问题排查及解决方法

Question

**问题描述：** 在使用 Docker Compose 部署服务时，出现 `Could not resolve host` 错误，导致服务无法正常启动。该问题通常发生在容器尝试访问外部服务（如数据库、API 或其他依赖服务）时无法解析对应主机名。常见原因包括 DNS 配置错误、服务名称拼写错误、网络模式配置不当或自定义网络未正确设置。排查时应检查 `docker-compose.yml` 文件中的服务名称与网络配置，确认容器内部 `/etc/resolv.conf` 是否正常，以及宿主机 DNS 是否可用。解决方法包括使用自定义网络、指定 DNS 服务器、修正服务名称或调整网络模式等。

Answer 1

1. 问题背景与现象描述

在使用 Docker Compose 部署微服务架构时，开发者常常会遇到容器启动失败的问题，其中一种典型错误是：Could not resolve host。该错误通常出现在容器尝试访问外部服务（如数据库、API、第三方服务）时，无法解析对应的主机名。

例如，服务 A 在启动时尝试连接数据库服务 db.example.com，但容器内无法解析该域名，导致连接失败，服务启动中断。

2. 常见原因分析

• DNS 配置错误：容器内部 DNS 设置不正确，无法解析外部域名。
• 服务名称拼写错误：在 docker-compose.yml 中引用的服务名称拼写错误或大小写不一致。
• 网络模式配置不当：使用了 host 模式或其他网络隔离模式，导致 DNS 解析失败。
• 自定义网络未正确设置：Docker Compose 默认为每个应用创建一个默认网络，但如果使用了自定义网络且未正确配置，则服务间无法通过服务名互相解析。
• 宿主机 DNS 不可用：宿主机的 DNS 服务异常或配置错误，影响了容器的 DNS 解析。

3. 排查步骤详解

1. 检查 docker-compose.yml 文件中的服务名称是否正确，尤其是连接其他服务的部分。
2. 进入容器内部查看 /etc/resolv.conf 内容，确认 DNS 地址是否正确。
3. 尝试在容器中执行 nslookup <host> 或 dig <host> 测试域名解析。
4. 确认宿主机的 DNS 配置是否正常，如 /etc/resolv.conf 或 systemd-resolved。
5. 检查 Docker 的默认网络或自定义网络配置，确保服务之间处于同一网络环境中。

4. 典型问题场景与解决方案

问题场景	原因	解决方案
容器无法解析外部域名	Docker 默认 DNS 配置无效	在 docker-compose.yml 中指定 dns 字段，如：dns: 8.8.8.8
服务间无法通过服务名通信	未使用自定义网络或服务未在同一网络中	定义自定义网络并确保服务加入同一网络
容器内 DNS 配置被覆盖	Docker Daemon 的 DNS 设置被修改	修改 Docker Daemon 配置文件 /etc/docker/daemon.json，设置默认 DNS

5. 示例：Docker Compose 配置修正

以下是一个修复后的 docker-compose.yml 示例，包含自定义网络和 DNS 设置：

version: '3.8'
services:
  webapp:
    image: my-webapp
    networks:
      - mynetwork
    dns:
      - 8.8.8.8
  db:
    image: postgres
    container_name: mydb
    networks:
      - mynetwork

networks:
  mynetwork:
    driver: bridge
    

6. 网络通信流程图

下图展示了容器之间通过服务名通信的基本流程：

graph TD
    A[Service A] -->|通过服务名访问| B(Docker DNS 解析)
    B --> C{解析成功?}
    C -->|是| D[Service B]
    C -->|否| E[报错: Could not resolve host]