使用Django将MySQL连接到Heroku时遇到连接异常

你的Django应用在Heroku上还在尝试连接本地MySQL服务器（通过/var/run/mysqld/mysqld.sock），这说明数据库配置没有正确读取ClearDB提供的远程数据库信息。我之前处理过完全相同的场景，给你几个关键修复步骤：

1. 确保settings.py正确解析ClearDB环境变量 #

你的DATABASES配置应该直接从Heroku的环境变量中读取，而不是硬编码本地信息。在settings.py里替换原来的SQLite配置为：

import dj_database_url
import os

DATABASES = {}
# 优先读取CLEARDB的原生URL
DATABASES['default'] = dj_database_url.config(default=os.environ.get('CLEARDB_DATABASE_URL'))
# 如果你已经设置了DATABASE_URL，也可以用这个：
# DATABASES['default'] = dj_database_url.config(default=os.environ.get('DATABASE_URL'))

注意：要确保你安装了dj-database-url这个包，它会自动把ClearDB的URL转换成Django需要的数据库配置格式。

2. 检查MySQL驱动是否安装 #

Heroku上的Python环境需要MySQL客户端驱动，在你的requirements.txt里添加：

mysqlclient>=2.2.0
# 若mysqlclient安装有兼容性问题，可替换为pymysql：
# pymysql>=1.1.0

如果选择用pymysql，还需要在settings.py开头添加以下代码：

import pymysql
pymysql.install_as_MySQLdb()

3. 验证Heroku环境变量是否正确 #

重新确认你的环境变量是否设置到位：

heroku config:get CLEARDB_DATABASE_URL
heroku config:get DATABASE_URL

确保这两个变量（至少一个）存在，并且是ClearDB提供的完整MySQL URL格式（比如mysql://用户名:密码@主机地址/数据库名）。

4. 重新部署并执行数据库迁移 #

更新配置后，重新推代码到Heroku，然后运行数据库迁移：

git add .
git commit -m "修复ClearDB数据库连接配置"
git push heroku main
heroku run python manage.py migrate

为什么会出现2002错误？ #

错误代码2002意味着Django尝试通过本地Unix socket连接MySQL，但ClearDB是远程云数据库，并不在Heroku的容器内。这个问题通常是因为：

• settings.py里的DATABASES配置仍硬编码了HOST: 'localhost'
• 没有正确读取Heroku的环境变量
• 缺少dj-database-url来解析数据库URL格式

按上面的步骤操作后，你的应用应该能正确连接到ClearDB的远程MySQL服务器了。

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