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

目前golang学习网上已经有很多关于文章的文章了，自己在初次阅读这些文章中，也见识到了很多学习思路；那么本文《为什么Django项目在Docker中连接MySQL失败_配置Python数据库主机名》，也希望能帮助到大家，如果阅读完后真的对你学习文章有帮助，欢迎动动手指，评论留言并分享~

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

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容器执行授权：

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监听端口了，但数据库还没初始化完、用户还没加载进内存、权限表还没刷盘。这个点容易被忽略。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~