EC2环境下pip提示mysqlclient安装成功但找不到包也无法卸载

第一步：先排除架构匹配问题 #

首先执行命令确认实例CPU架构：

(venv3)$ uname -m

• 如果输出为aarch64（AWS Graviton系列ARM实例），你当前使用的pip 21.0.1存在whl平台标签匹配bug，会错误拉取x86_64版本的mysqlclient whl，安装时二进制不兼容会静默跳过，直接跳至第三步执行源码编译安装即可
• 如果输出为x86_64，继续执行以下检查

第二步：检查pip配置与路径权限 #

执行命令查看pip的安装目标路径与配置：

(venv3)$ pip config list
(venv3)$ python -m pip install -v mysqlclient

• 重点看verbose输出里的元数据写入路径，以及是否有权限不足的警告
• 如果配置里有全局的target、user参数，临时移除配置后再试：

(venv3)$ pip install --no-config mysqlclient

• 再检查venv的site-packages目录权限：

(venv3)$ python -c "import site; print(site.getsitepackages()[0])"
(venv3)$ ls -ld <上一步输出的路径>

• 如果路径属主为root，执行权限修正：

(venv3)$ sudo chown -R ec2-user:ec2-user ~/venv3/

注意：pip 21.0.1存在已知bug，当包的元数据（.dist-info目录）写入失败时，会直接返回安装成功提示，但实际不会写入任何包文件

第三步：源码编译安装规避预编译包问题 #

不管是架构匹配问题还是pip元数据bug，直接禁用预编译包，从源码编译安装，所有错误都会显式输出：

1. 先安装Amazon Linux环境下的编译依赖：

(venv3)$ sudo yum install python3-devel mysql-devel gcc

2. 强制从源码安装mysqlclient：

(venv3)$ pip install --no-binary :all: mysqlclient==2.0.3

第四步：验证安装结果 #

执行以下命令确认包正常落地：

(venv3)$ pip show mysqlclient
(venv3)$ python -c "import MySQLdb; print(MySQLdb.get_client_info())"

• 以上命令都输出正常后，再启动Django shell即可

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