### 解决 Docker 容器内服务无法连接本地数据库的方法 #### 1. 理解网络隔离机制 Docker 容器具有独立的网络命名空间，这意味着容器内部的服务默认情况下无法直接通过 `localhost` 或 `127.0.0.1` 访问宿主机上的服务。这是因为这些地址指向的是容器自身的回环接口而非宿主机的[^2]。 #### 2. 使用正确的 IP 地址或 DNS 名称 为了使容器能够访问宿主机上的 MySQL 数据库，可以采用以下几种方法之一： - **使用特殊 IP 地址**：在某些操作系统上（如 Mac 和 Windows），可以通过特定的 IP 地址（例如 `host.docker.internal`）来访问宿主机。这使得容器可以直接连接到该地址下的 MySQL 实例。 - **查找并指定宿主机的真实 IP**：如果是在 Linux 上运行，则可能需要找到实际分配给宿主机网络接口的 IP 地址，并将其配置为客户端程序中的数据库服务器地址。 ```bash ip addr show docker0 | grep inet | awk '{print $2}' | cut -d '/' -f1 ``` 这段命令可以帮助获取用于通信的网桥设备 `docker0` 的 IPv4 地址。 #### 3. 配置端口映射 确保 MySQL 服务已经正确设置了监听外部请求所需的端口号，并且已经在启动 Docker 容器时指定了相应的端口转发规则。这样即使不依赖于具体的 IP 地址也可以让其他地方的应用程序通过标准方式 (`localhost:3306`) 来建立连接[^3]。 ```json { "ExposedPorts": { "3306/tcp": {} }, ... } ``` 这是 JSON 片段展示了如何定义暴露出来的端口，在创建镜像文件时应该包含类似的设置以便允许外界访问。 #### 4. 考虑在同一网络下部署多个容器 另一种常见的做法是将 Web 应用和服务端放在同一个自定义 Docker 网络里边，从而简化它们之间的交互过程。这种方式不需要担心复杂的跨平台兼容性和防火墙策略等问题。 ```yaml version: '3' services: webapp: image: my-web-app-image networks: - app-network db: image: mysql:latest environment: MYSQL_ROOT_PASSWORD: example ports: - "3306:3306" networks: - app-network networks: app-network: driver: bridge ``` 上述 YAML 文件片段展示了一个简单的多服务组合方案，其中两个组件共享相同的用户定义桥梁型网络(`bridge`)，方便互相发现对方的存在并通过名称解析来进行调用。