如何解决独立部署的Django Docker容器无法连接MySQL容器的问题

问题根源 #

你遇到的主机解析失败问题，核心原因是 Docker默认的bridge网络不支持容器名DNS自动解析：

• 你两个服务都指定了network_mode: bridge，也就是加入Docker默认的桥接网络，该网络仅支持通过IP地址互访，无法直接识别容器名/服务别名，external_links配置在高版本Docker的默认bridge下经常失效。
• 额外注意：你的Django Dockerfile中开头的FROM ubuntu:18.04是冗余无效的，多阶段构建后续的FROM python:3.8.6-buster会完全丢弃前一个Ubuntu镜像层，不影响运行但可以删除。

解决方案 #

推荐方案：使用自定义桥接网络（稳定永久有效） #

1. 先手动创建公共桥接网络，执行命令：

docker network create django-mysql-bridge

2. 修改MySQL的docker-compose.yaml：
   删除原来的network_mode: bridge配置，替换为指定使用刚创建的公共网络：

version: "3"
services:
  db:
    platform: linux/x86_64
    image: mysql:5.7
    container_name: good-mysql
    ports:
      - "3307:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=test
      - MYSQL_DATABASE=testdb
    command: 
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_unicode_ci
    volumes:
      - /Users/Shared/data/mysql-test:/var/lib/mysql
networks:
  default:
    external: true
    name: django-mysql-bridge

3. 修改Django的docker-compose.yaml：
   删除external_links和原来的network_mode: bridge配置，同样指定公共网络：

version: '3.8'
services:
    deepnatural-ai-api:
        build: .
        image: deepnatural-ai-api:latest
        container_name: deepnatural-ai-api
        ports:
            - 1000:1000
networks:
  default:
    external: true
    name: django-mysql-bridge

4. 重启两个服务：
   先停掉原来的容器，再重新执行docker-compose up -d启动两个服务，Django的settings.py里数据库HOST填good-mysql，端口3306即可正常连接。

临时解决方案（不推荐，容器重启可能失效） #

如果不想调整网络配置，可以直接用MySQL容器的内网IP连接：

1. 执行命令获取MySQL容器的内网IP：

docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' good-mysql

2. 将获取到的IP填写到Django settings.py的数据库HOST参数即可。

连通性校验 #

如果修改后还是连接失败，可以进入Django容器执行以下命令排查：

# 安装网络工具
apt update && apt install -y iputils-ping telnet
# 测试域名解析
ping good-mysql
# 测试端口连通性
telnet good-mysql 3306

内容的提问来源于stack exchange，提问作者Jade Han