源码编译安装mysql时启用插件必须在cmake阶段显式指定如-dwith_federated_storage_engine=1等开关,并确保libmemcached-devel等依赖已安装,否则make不生成对应.so文件,导致install plugin失败。

源码编译安装 MySQL 时启用插件,不是装完再“插”,而是编译阶段就决定哪些插件能被构建、链接和加载。跳过这步直接 INSTALL PLUGIN 很可能失败——因为对应插件的 .so 文件压根没生成。
cmake 阶段必须显式开启插件构建选项
MySQL 源码中多数插件(如 innodb_memcached、federated、archive、blackhole)默认不编译,需在 cmake 命令中用 -DWITH_XXX_STORAGE_ENGINE=ON 或类似开关激活。否则 make 不会生成对应动态库,后续 INSTALL PLUGIN 会报错 Plugin 'xxx' is not installed。
-
-DWITH_INNOBASE_STORAGE_ENGINE=ON:InnoDB 引擎(默认开启,但显式声明更稳妥) -
-DWITH_FEDERATED_STORAGE_ENGINE=1:FEDERATED 引擎(注意是数字1,不是ON) -
-DWITH_ARCHIVE_STORAGE_ENGINE=1:ARCHIVE 引擎 -
-DWITH_BLACKHOLE_STORAGE_ENGINE=1:BLACKHOLE 引擎 -
-DWITH_INNODB_MEMCACHED=ON:memcached 接口(依赖 libmemcached,需提前安装libmemcached-devel)
错误示例:cmake .. -DWITH_FEDERATED_STORAGE_ENGINE=ON → 实际应为 =1,否则 cmake 会静默忽略该选项。
某些插件依赖外部开发库,缺一不可
不是所有插件光靠 cmake 开关就能启用。比如 innodb_memcached 依赖 libmemcached 头文件和库;ldap 认证插件依赖 openldap-devel;openssl 相关功能依赖 openssl-devel。系统里没有对应 -devel 包,cmake 会跳过该插件并打印 warning,你可能根本没注意到。
- CentOS/RHEL:
yum install libmemcached-devel openldap-devel openssl-devel - Ubuntu/Debian:
apt-get install libmemcached-dev libldap2-dev libsasl2-dev libssl-dev - cmake 输出中留意类似
-- Could NOT find LibMemcached (missing: LIBMEMCACHED_LIBRARY LIBMEMCACHED_INCLUDE_DIR)的提示
若忽略这类 warning,后续执行 INSTALL PLUGIN innodb_memcached SONAME "libmemcached.so" 会失败,报错 Can't open shared library '/usr/local/mysql/lib/plugin/libmemcached.so' (errno: 2, No such file or directory)。
编译后确认插件文件是否真实存在
插件能否加载,最终取决于 lib/plugin/ 目录下是否有对应 .so 文件。不要只信 cmake 日志,要动手验证:
- 编译安装完成后,进入
<code>lib/plugin/目录:ls /usr/local/mysql/lib/plugin/ | grep -i federated - 常见插件对应文件名:
federated.so、ha_federated.so、innodb_memcached.so、auth_socket.so - 若缺失,说明 cmake 阶段未启用或依赖未满足,需重新
cmake并检查输出
特别注意:mysql_native_password 和 caching_sha2_password 是服务端内置认证方式,不对应独立 so 文件;而 auth_socket、auth_ldap 才是真正需要编译生成的插件。
运行时加载插件前,先检查变量与权限
即使 so 文件存在,INSTALL PLUGIN 仍可能失败。两个硬性前提常被忽略:
-
secure_file_priv必须为空或包含 plugin 目录路径,否则INSTALL PLUGIN xxx SONAME 'xxx.so'报错Variable 'secure_file_priv' is set to a non-empty value - 用户需有
INSERT权限到mysql.plugin表(通常 root 有,但自定义账户需显式授权) - 插件名大小写敏感:
INSTALL PLUGIN FEDERATED SONAME 'ha_federated.so'中FEDERATED必须全大写
启动 mysqld 时加 --plugin-load-add=federated.so 可设为开机自动加载,但前提是该 so 文件已在 plugin_dir 下且路径正确——这个路径由 plugin_dir 系统变量决定,不是你 cmake 时指定的 lib/plugin 路径的绝对值,而是相对安装前缀的路径(默认就是 lib/plugin)。
最易被跳过的环节是:以为开了 cmake 选项就万事大吉,结果没装 libmemcached-devel,cmake 默默跳过 innodb_memcached,最后在 SQL 里反复 INSTALL PLUGIN 失败却查不到原因。务必逐级验证:依赖 → cmake 输出 → so 文件存在 → secure_file_priv → 权限。











