在Vercel部署Django应用时安装mysqlclient失败求助

问题原因 #

Vercel默认构建环境未预装MySQL/MariaDB开发依赖包，mysqlclient编译时需要调用mysql_config工具，因工具缺失导致安装流程中断。

解决方案 #

方案一：替换为纯Python MySQL客户端（推荐） #

改用无需编译的纯Python类库，避开系统依赖问题：

• 修改requirements.txt，将mysqlclient替换为mysql-connector-python或pymysql
• 若选择pymysql，需在Django项目根目录的__init__.py文件中添加以下代码，让Django兼容该库：

import pymysql
pymysql.install_as_MySQLdb()

修改完成后重新部署即可，无需调整构建环境配置。

方案二：在构建阶段安装系统依赖 #

若坚持使用mysqlclient，需在Vercel构建流程中先安装MySQL开发依赖：

1. 在项目根目录创建或修改vercel.json文件，配置自定义构建命令：

{
  "buildCommand": "apt-get update && apt-get install -y default-libmysqlclient-dev && pip install -r requirements.txt && python manage.py collectstatic --noinput"
}

2. 提交修改后重新触发Vercel部署，构建环境会先安装所需的MySQL开发库，再执行依赖安装和Django静态文件收集操作。

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