好，咱就直接开聊。最近好几个人问我，为什么 Django 连接数据库这么折腾，明明按教程一步步来，要么报错，要么连不上。这事儿我太懂了，当年自己踩坑踩到怀疑人生。今天咱从头捋一遍，从零开始配置 Django 连接数据库，手把手带你避开常见的坑。你准备好了没？咱这就开干。
先说第一个坑：版本匹配。很多人一上来就 ，再 ，结果一运行 ，直接崩了。为啥？版本不对付。Django 3.x 与 4.x 对数据库驱动的支持不一样，MySQL 8.0 与 5.7 的认证方式也有区别。比如用 Django 4.2 去连 MySQL 5.7，默认的 认证大概率会出问题。正确做法是：先查清楚你用的 Django 版本支持哪些数据库版本，去官方文档看一眼，别嫌麻烦。比如 Django 4.2 支持 MySQL 8.0.11 以上，就别用 5.7 了。同理，Python 版本也得对上，Django 4.2 要求 Python 3.8 以上，Python 3.6 是装不上的。所以第一步，先确认三件套：Python 版本、Django 版本、数据库版本，都匹配好再往下走。
接下来是安装驱动。很多人卡在这一步， 报错，说缺少 。这玩意儿在 Windows 上特别麻烦，Linux 上反而简单。Windows 用户建议直接去 PyPI 下载对应的 whl 文件，别在命令行硬怼。找一个和你的 Python 版本、系统位数匹配的 whl，例如 Python 3.10 64 位，就下载对应的文件，然后 。Linux 用户只需 ，再 ，基本一次通过。若使用 PostgreSQL，就装 或 ，后者省事但生产环境不推荐。SQLite 是 Django 自带的，本地开发测试没问题，但生产环境别用，并发高了会卡死。驱动装好后，打开 Python 交互环境，（或 ），不报错就说明成功。
然后说配置 。这一步看似简单，却是坑最多的地方。 字典里， 必须写对：MySQL 用 ，PostgreSQL 用 ，SQLite 用 。 填数据库名， 填用户名， 填密码， 填地址（本地一般是 或 ）， 填端口，MySQL 默认 3306。常见错误是把 写成了数据库文件路径，那是 SQLite 的写法；还有人不填 ，默认走 socket 文件，结果连不上。密码里如果有特殊字符（如 ），要么用引号包起来，要么进行 URL 编码，否则 Django 解析时会把它当成连接符。建议密码使用字母数字组合，省心省事。
配置完成后，跑 ，看看有没有报错。这里大概率会碰到几个典型问题。第一种是，说明连不上 MySQL 服务。检查 MySQL 是否已启动：Windows 在服务管理器查看，Linux 用 。确认端口是否正确，防火墙是否放行 3306。第二种常见错误是，密码错误或用户权限不足。建议在 MySQL 中创建专用用户，例如：不要直接用 root 开发，不安全，而且 root 默认只能用 socket 连接，填 反而会被拒绝。
再往下，数据库字符集也是个坑。Django 默认使用 ，但 MySQL 的 实际是 ，无法存储 emoji 和部分生僻字。要使用 ，在建库时指定：随后在 中加入选项：这样数据就不会出现“问号乱码”。还有一个容易忽略的点是时区。Django 默认使用 UTC，而数据库可能存的是本地时间，查询时会出现偏差。可以在 中设置 ，或者 ，并确保数据库的时区设置一致。
连接池也是需要留意的点。Django 默认每个请求都会新建一个数据库连接，请求结束后关闭。高并发下频繁创建销毁连接会影响性能。可以使用 或者直接借助 SQLAlchemy 的池化功能。不过别一开始就上，先跑通基础连接，确认没有问题后再优化。另一个坑是连接超时。MySQL 的 默认 8 小时，如果应用长时间没有请求，连接会被断开，下一次请求时 Django 仍拿着旧连接，就会报 “MySQL server has gone away”。解决办法是在 中设置 ，例如 （保活 10 分钟），或者使用第三方库实现自动重连。
说点实战技巧。可以在 Django 的 里测试连接：返回 就说明连接成功。写代码时注意捕获数据库异常，如 、，别让错误直接抛给用户。数据库迁移文件要和代码一起放入版本控制，别删了重来，否则生产环境恢复不了。初始化数据可以使用 fixture，或者编写自定义的 management command，比分别手动插入更可靠。
好了，从零配置 Django 连接数据库这件事，说复杂也复杂，说简单也简单。关键是别着急，每一步都确认后再进行下一步。版本匹配、驱动安装、配置细节、权限设置、字符集、时区、连接池、超时处理，每个环节都可能出问题。但只要按照上面的流程走一遍，基本能避开 90% 的常见坑。剩下的 10% 就要靠你多动手、多查报错信息了。记住，看官方文档永远比二手教程靠谱，报错信息里往往藏着答案。下次再碰到连不上数据库，先检查配置，再查看服务状态和日志。祝你一路顺风，不再踩坑。
