mysql如何排查插件加载失败原因_mysql plugin目录与权限核对

MySQL插件加载需确认plugin_dir路径一致、文件名及权限正确、错误日志无报错、插件状态与变量启用匹配：先查SELECT @@plugin_dir;，再验证文件存在、权限、架构，最后查error.log和information_schema.PLUGINS。查 plugin_dir 实际路径和当前值是否一致MySQL 启动时只认 plugin_dir 配置指向的目录，不是"默认位置"或"常见路径"。很多人改了配置文件却没重启 mysqld，或者在多个配置文件（/etc/my.cnf、/etc/mysql/my.cnf、~/.my.cnf）里写冲突了，导致实际生效的 plugin_dir 和你以为的不一样。连上 MySQL 执行 SELECT @@plugin_dir;，这是唯一可信的运行时路径用 mysqld --verbose --help | grep plugin-dir 看启动时解析出的默认值（未显式配置时才参考）检查 my.cnf 中是否有 plugin_dir 项，确认它不在被注释掉的块里，且没有被后续配置覆盖确认插件文件存在且命名符合平台规范MySQL 插件不是扔进目录就行------文件名必须带后缀，且后缀因系统而异：.so（Linux）、.dll（Windows）、.dylib（macOS）。少一个字母、多一个空格、大小写错（比如 semisync_master.so 写成 semisync_master.SO），加载就静默失败。进入 @@plugin_dir 目录，用 ls -l 确认插件文件真实存在、可读检查文件权限：MySQL 进程用户（如 mysql）必须有读+执行权限（chmod 755 xxx.so 是安全的起点）用 file xxx.so 确认是对应架构的动态库（例如 x86_64，不是 aarch64 或编译目标不匹配）加载时看错误日志，别只信 INSTALL PLUGIN 返回 OKINSTALL PLUGIN 成功只代表语句语法通过、注册表写入完成，不代表动态库真加载进内存。真正报错藏在错误日志里，而且往往只有 warning 级别，容易被忽略。 Mokker AI AI产品图添加背景