为什么Django项目在Docker中连接MySQL失败_配置Python数据库主机名-Python教程-PHP中文网

docker环境下django连接mysql时，host必须设为docker-compose中定义的mysql服务名（如'db'），而非'localhost'或'127.0.0.1'；需授权用户允许'%'主机访问，并安装mysqlclient依赖，同时通过healthcheck和wait-for-it确保mysql就绪后再启动django。

为什么django项目在docker中连接mysql失败_配置python数据库主机名

docker-compose里MySQL的HOST必须填容器名，不是localhost

在Django的DATABASES配置中把HOST写成'localhost'或'127.0.0.1'，是Docker环境下最常踩的坑。这是因为Django运行在自己的容器里，localhost指向的是它自己这个容器的回环地址，而不是MySQL容器。

正确做法是把HOST设为MySQL服务在docker-compose.yml中定义的service name，比如：

services:
  db:
    image: mysql:5.7
    container_name: yy_mysql
  web:
    build: .
    depends_on:
      - db

那么Django里就要写：

'HOST': 'db',  # 不是 'localhost'，也不是 '127.0.0.1'

容器网络默认走Docker内部DNS，db会被自动解析为MySQL容器的IP
如果硬写127.0.0.1，Django会尝试连自己容器的3306端口——那根本没MySQL在跑
localhost在容器内通常只走Unix socket，而MySQL容器默认不暴露socket文件给其他容器

MySQL用户权限必须允许'%'主机，不能只给'localhost'

Django容器发起的连接，源IP是Docker桥接网段里的一个动态地址（比如172.18.0.3），不是localhost。所以MySQL里只创建了'user'@'localhost'用户，Django一定连不上，报错类似：Access denied for user 'root'@'172.18.0.3'。

进MySQL容器执行授权：

Django Unfold

提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。

下载

CREATE USER 'myuser'@'%' IDENTIFIED BY 'mypass';
GRANT ALL ON mydb.* TO 'myuser'@'%';
FLUSH PRIVILEGES;

别删掉'myuser'@'localhost'——本地调试时可能还需要
生产环境可收紧为具体网段，如'myuser'@'172.18.0.%'，但开发阶段用'%'最省事
确认mysql.user表里确实有对应Host值：SELECT User, Host FROM mysql.user WHERE User = 'myuser';

django.db.backends.mysql需要mysqlclient，不是PyMySQL

虽然早期教程教你在__init__.py里用pymysql.install_as_MySQLdb()来“伪装”，但在Docker+Django现代组合里这招基本失效。Django 3.2+、Python 3.8+、mysqlclient 2.1+ 已经形成稳定链路，强行用PyMySQL反而触发编码、事务、时区等隐性问题。

你应该在Dockerfile里装mysqlclient，而不是pymysql：

RUN apt-get update && apt-get install -y \
      default-libmysqlclient-dev \
      python3-dev \
      build-essential \
    && pip install mysqlclient

缺default-libmysqlclient-dev会导致mysqlclient编译失败，报错含mysql.h: No such file or directory
不要在requirements.txt里混写pymysql和mysqlclient，依赖冲突会静默失败
mysqlclient是C扩展，性能和兼容性都优于纯Python的pymysql

Django启动前必须等MySQL就绪，否则报2002错误

即使所有配置都对，docker-compose up一启动，Django容器经常比MySQL快几秒先跑manage.py runserver，这时MySQL还没初始化完，就会报：OperationalError: (2002, "Can't connect to MySQL server on 'db' (115)")。

不能靠depends_on解决——它只保证容器启动顺序，不保证服务就绪。得加健康检查和启动等待逻辑：

在docker-compose.yml里给db加healthcheck：

healthcheck:
  test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p123456"]
  timeout: 20s
  retries: 10

在Django容器的启动命令里加等待脚本（比如用wait-for-it.sh）：

command: sh -c "pip install wait-for-it && wait-for-it db:3306 -- python manage.py runserver 0.0.0.0:8000"

真正卡住的地方往往不是配置写错，而是服务间“时间差”没处理好——MySQL监听端口了，但数据库还没初始化完、用户还没加载进内存、权限表还没刷盘。这个点容易被忽略。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！