安装mysqlclient构建wheel失败，链接器找不到mariadbclient.lib

核心问题分析 #

安装过程中触发的LNK1181: 无法找到输入文件'mariadbclient.lib'是导致构建失败的直接原因；setuptools的许可证格式警告属于次要提示，不影响安装结果。

解决方案 #

1. 解决链接器找不到库文件的问题 #

• 安装开发包：确保系统中已安装包含mariadbclient.lib（或mysqlclient.lib）的MariaDB/MySQL开发库，而非仅客户端程序。Windows用户在安装时需勾选"Development Components"选项。
• 配置环境变量：将包含mariadbclient.lib的路径（如C:\Program Files\MariaDB 10.11\lib）添加到系统LIB环境变量中，添加后重启终端再执行安装命令。
• 使用预编译wheel跳过源码构建：
  执行命令强制使用二进制包：

  pip install mysqlclient --only-binary :all:
  

  若仍失败，可手动下载对应Python版本、系统架构的wheel包（如mysqlclient-2.2.0-cp311-cp311-win_amd64.whl），再执行本地安装：

  pip install path/to/mysqlclient-xxx.whl
  

2. 消除setuptools弃用警告 #

若需解决许可证格式警告，修改项目根目录的pyproject.toml：

• 将旧的project.license格式替换为SPDX标识符，例如：
  旧写法：

  project.license = "MIT License"
  [project.classifiers]
  "License :: OSI Approved :: MIT License" = true
  

  新写法：

  project.license = { identifier = "MIT" }
  

• 移除project.classifiers中过时的许可证分类器条目。

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