Python2.7使用mysqlclient报错：MySQLdb/_mysql.so, 0x0002): symbol not found in flat namespace ‘_mysql_kill

环境

• MacOS 14
• M2 芯片
• Python 2.7
• mysqlclient==1.4.4
• mysql 8.x

安装 mysqlclient其他报错可参考 macos pip install mysqlclient error: command ‘/usr/bin/clang‘ failed with exit code 1

报错信息

  File "xx/models/mysql.py", line 4, in <module>
    import MySQLdb
  File "xx/python2.7/site-packages/MySQLdb/__init__.py", line 18, in <module>
    from . import _mysql
ImportError: dlopen(xx/python2.7/site-packages/MySQLdb/_mysql.so, 0x0002): symbol not found in flat namespace '_mysql_kill'

问题分析

_mysql_kill 是 MySQL C 客户端库中的一个符号，一般用于终止 MySQL 服务器上的某个线程。在 Python 的 MySQLdb （也就是 mysqlclient ） 库里，它会调用这个底层的 MySQL C 客户端库函数。

版本支持情况

• 较旧版本支持：在 MySQL 5.x 系列以及早期的 MySQL 版本中，_mysql_kill 是被支持的。mysqlclient 库早期也是按照这些 MySQL 版本来进行开发和测试的，因此在使用这些较旧的 MySQL 版本时，通常能很好地与 mysqlclient 配合使用，较少出现找不到 _mysql_kill 符号的问题。
• MySQL 8.x 版本问题：从 MySQL 8.x 开始，在某些配置或者安装情况下，可能会出现 symbol not found in flat namespace ‘_mysql_kill’ 这类错误。这并非是 MySQL 8.x 不支持 _mysql_kill 这个函数本身，而是由于 MySQL 8.x 在架构、认证方式、库文件结构等方面有了较大改变，比如默认的认证插件从 mysql_native_password 变为 caching_sha2_password，这可能导致 mysqlclient 在与 MySQL 8.x 集成时出现兼容性问题，从而引发找不到该符号的错误。

解决方案

# 安装的前提
  export CPPFLAGS="-I$(brew --prefix openssl@1.1)/include -I$(brew --prefix libffi)/include -I$(brew --prefix readline)/include -I$(brew --prefix zstd)/include"
  export CFLAGS="-I$(brew --prefix openssl@1.1)/include -I$(brew --prefix bzip2)/include -I$(brew --prefix readline)/include -I$(xcrun --show-sdk-path)/usr/include -Wno-implicit-function-declaration -I$(brew --prefix zstd)/include" 
  export LDFLAGS="-L$(brew --prefix openssl@1.1)/lib -L$(brew --prefix readline)/lib -L$(brew --prefix zlib)/lib -L$(brew --prefix bzip2)/lib -L$(brew --prefix gettext)/lib -L$(brew --prefix libffi)/lib -L$(brew --prefix zstd)/lib"

# 安装低版本mysql
brew install mysql@5.7

# 加载编译相关参数
export LDFLAGS="-L$(brew --prefix mysql@5.7)/lib ${LDFLAGS}"
export CPPFLAGS="-I$(brew --prefix mysql@5.7)/include ${CPPFLAGS}"
export PKG_CONFIG_PATH="$(brew --prefix mysql@5.7)/lib/pkgconfig"
export DYLD_LIBRARY_PATH="$(brew --prefix mysql@5.7)/lib:${DYLD_LIBRARY_PATH}"

安装成功后服务运行不报错。