Amazon EB部署Django应用时mysqlclient2.2.0自动安装失败求助

问题场景 #

在64位Amazon Linux 2平台部署Python 3.8的Django测试应用，执行eb deploy后部署失败。查看eb-engine.log发现系统持续尝试安装mysqlclient 2.2.0并失败，核心报错：

Exception: Can not find valid pkg-config name.
Specify MYSQLCLIENT_CFLAGS and MYSQLCLIENT_LDFLAGS env vars manually

已手动卸载mysqlclient并从requirements.txt中移除，但问题依旧。当前requirements.txt包含mysql-connector-python==8.0.28和PyMySQL==1.0.2，.ebextensions/01_django.config中已配置yum安装MySQL-python和mariadb-devel。

核心排查点 #

• 隐性依赖触发安装：部分Django第三方库（如django-rest-auth、django-allauth）可能间接依赖mysqlclient，导致pip自动尝试安装，即使requirements.txt未直接声明。
• yum依赖不完整：Amazon Linux 2上编译mysqlclient需要完整的编译工具链和MySQL/MariaDB开发包，仅安装mariadb-devel不足以支持编译。
• 容器命令配置错误：.ebextensions中container_commands重复定义command字段，仅最后一条命令会执行；且未正确激活虚拟环境可能引发依赖检测异常。

分步解决方案 #

方案1：用纯Python驱动替代mysqlclient（无需编译） #

利用已有的PyMySQL配置Django，绕过编译依赖问题：

1. 在Django项目根目录的__init__.py（如myophio/__init__.py）中添加：

import pymysql
pymysql.install_as_MySQLdb()

2. 确保settings.py的数据库引擎配置为：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        # 补充NAME、USER、PASSWORD等其他配置
    }
}

方案2：补全编译依赖，支持mysqlclient安装 #

若必须使用mysqlclient，完善.ebextensions配置：

1. 修改.ebextensions/01_django.config的packages部分，添加编译工具和完整开发包：

packages:
    yum:
      mariadb-devel: []
      gcc: []
      python3-devel: []
      pkgconfig: []

2. （可选）在option_settings中添加编译环境变量，强制指定mysqlclient的编译路径：

option_settings:
  aws:elasticbeanstalk:application:environment:
    # 保留原有配置
    MYSQLCLIENT_CFLAGS: "-I/usr/include/mysql"
    MYSQLCLIENT_LDFLAGS: "-L/usr/lib64/mysql -lmysqlclient"

方案3：修复容器命令配置 #

修正.ebextensions/01_django.config中重复command的问题，确保两条命令都执行：

container_commands:
  01_migrate:
    command: "source /var/app/venv/*/bin/activate && python3 manage.py migrate"
    leader_only: true
  02_collectstatic:
    command: "source /var/app/venv/*/bin/activate && python3 manage.py collectstatic --noinput"
    leader_only: true

验证步骤 #

1. 清理本地虚拟环境，重新生成requirements.txt（确保无隐性依赖）：

pip freeze > requirements.txt

2. 重新部署：

eb deploy

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