升级Mac Sonoma后mysqlclient Python包无法正常运行求助

安全阿岳

2026-7-8

解决Mac Sonoma升级后mysqlclient无法连接MySQL的问题

先排查环境变量路径是否正确

Sonoma升级后，Apple Silicon机型的Homebrew默认路径已从/usr/local改为/opt/homebrew，先确认你的brew安装路径：

执行brew --prefix mysql-client，如果输出是/opt/homebrew/opt/mysql-client，说明之前的环境变量路径错误。

修正.zshrc里的环境变量：

export LDFLAGS="-L/opt/homebrew/opt/mysql-client/lib"
export CPPFLAGS="-I/opt/homebrew/opt/mysql-client/include"
export PKG_CONFIG_PATH="/opt/homebrew/opt/mysql-client/lib/pkgconfig"

执行source ~/.zshrc重新加载配置，再用echo $LDFLAGS等命令确认变量生效。

重新编译安装mysqlclient

卸载旧版本后，指定正确路径重新安装：

卸载现有mysqlclient：pip uninstall -y mysqlclient

带环境变量重新安装：

LDFLAGS="-L$(brew --prefix mysql-client)/lib" CPPFLAGS="-I$(brew --prefix mysql-client)/include" pip install mysqlclient

若仍报错，尝试安装最新版：pip install mysqlclient --upgrade

检查MySQL服务与兼容性

重启MySQL服务：brew services restart mysql
确认MySQL版本≥8.0，Sonoma对旧版MySQL兼容性较差，若版本过低，执行brew upgrade mysql升级。

调整Django数据库配置

在settings.py中添加SSL禁用选项（Sonoma默认强制SSL连接可能导致失败）：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': '你的数据库名',
        'USER': '数据库用户名',
        'PASSWORD': '数据库密码',
        'HOST': '127.0.0.1',
        'PORT': '3306',
        'OPTIONS': {
            'ssl_mode': 'DISABLED',
            'charset': 'utf8mb4',
        },
    }
}