MySQL多版本连接需统一客户端与服务端版本、显式指定default_auth、环境变量控制参数、统一max_allowed_packet配置、用docker volume避免权限问题，并验证sql_mode和collation差异。
MySQL 多版本连接配置怎么避免 mysql\_client\_plugin\_init 报错
不同 mysql 版本（尤其是 5.7 / 8.0 / 8.4）的客户端插件机制和默认认证方式差异很大，mysql\_client\_plugin\_init 失败常源于客户端库与服务端不匹配。不是驱动问题，而是连接初始化时插件加载失败。
实操建议：
- 用
mysql --version和mysqld --version确认两端版本，不要只信文档或 Docker tag 名字（比如mysql:8可能是 8.0 或 8.4） - 在连接字符串里显式指定
?default\_auth=mysql\_native\_password（对 8.0+ 降级兼容）或?default\_auth=caching\_sha2\_password（对 8.0.4+ 原生支持） - Python 的
pymysql默认不启用插件，但mysqlclient会尝试加载；若报mysql\_client\_plugin\_init错误，加参数read\_default\_group='client'并在~/.my.cnf中配[client]段落，禁用插件：plugin_dir = ""
测试脚本里如何自动切换 MySQL 5.7 / 8.0 连接参数
硬编码不同版本的 host、port、user 很容易漏改，更危险的是忽略 sql\_mode 和 collation 差异导致测试通过但线上出错。
实操建议：
- 用环境变量控制核心参数：启动容器时设
MYSQL_VERSION=8.0，脚本里读取后决定是否加auth_plugin='caching_sha2_password' - 所有测试前执行一次
SELECT VERSION(), @@sql_mode, @@collation_server，日志里打出来，出问题立刻可定位 - Docker Compose 测试环境里，给每个 MySQL 服务加固定
ports: ["3307:3306"]，避免本地127.0.0.1:3306被占导致连错实例
为什么 max_allowed_packet 在 5.7 和 8.0 行为不一致
MySQL 8.0 默认把 max_allowed_packet 设为 64MB，而 5.7 是 4MB；但客户端（如 JDBC、mysqlclient）若没同步调大缓冲区，会直接断连并报 Packets larger than max_allowed_packet are not allowed，而不是优雅降级。
实操建议：
- 服务端配置里统一设
max_allowed_packet = 64M（5.7 也支持），但必须同时在客户端连接参数里加max_allowed_packet=67108864（单位字节） - JDBC URL 加
&maxAllowedPacket=67108864；Python 的mysqlclient需传参max_allowed_packet=67108864，不能只靠服务端 - 注意：该值在运行时不可动态改，必须重启 mysqld 或重连客户端，CI 流水线里别指望 SET GLOBAL 生效
CI 中用 Docker 启 MySQL 多版本时，/var/lib/mysql 权限和 datadir 初始化失败怎么解
Docker 官方镜像从 8.0.26 开始默认以非 root 用户运行，但挂载宿主机目录时若权限不对，mysqld 启动直接失败，日志只显示 Can't start server : Bind on unix socket 这类误导信息。
实操建议：
- 永远用
docker volume create替代-v ./data:/var/lib/mysql，避免 UID/GID 冲突 - 如果必须挂载宿主机路径，先
chown -R 999:999 ./mysql-data（MySQL 8.x 默认用户 UID 是 999） - MySQL 5.7 镜像默认 UID 是 184，混用时务必检查
docker inspect mysql:5.7 | grep User，再对应 chown
多版本兼容不是拼凑配置，而是每个连接点都得确认「谁在读、谁在写、谁在解析」——比如一个 SET NAMES utf8mb4 在 5.7 是安全的，在 8.4 里可能被忽略，因为默认已经是 utf8mb4_collation_520_ci。这种细节不会报错，但会让字符乱码藏到上线后才爆发。
