mysql 8.0 卸载插件后必须手动清理 mysql.plugin 表残留记录、udf 函数定义、动态权限/角色及 plugin_dir 中文件,否则易致权限绕过、函数调用崩溃或服务启动失败;操作前需备份表并停服执行。

MySQL 8.0 卸载插件后不会自动清理权限、UDF 函数或系统表残留,必须手动干预,否则可能引发权限绕过、函数调用失败或 mysql.plugin 表损坏等安全与稳定性问题。
检查并删除 mysql.plugin 表中残留的插件记录
插件卸载不彻底时,mysql.plugin 表仍保留已删除插件的条目,导致后续执行 INSTALL PLUGIN 或服务重启时报错 “Plugin ‘xxx’ is not loaded”,甚至阻塞初始化流程。
- 先用
SELECT * FROM mysql.plugin WHERE name = 'your_plugin_name';确认是否存在残留记录 - 若存在,执行
DELETE FROM mysql.plugin WHERE name = 'your_plugin_name';(注意:不能用DROP PLUGIN,因插件二进制文件已不存在) - 执行后必须运行
FLUSH PRIVILEGES;,否则部分内部缓存可能未更新 - 该表是 MyISAM 引擎,不支持事务,删错无法回滚,操作前建议备份整张表:
CREATE TABLE plugin_backup AS SELECT * FROM mysql.plugin;
清除 UDF 函数定义但未删除共享库的风险
若插件是通过 CREATE FUNCTION ... SONAME 注册的 UDF,卸载时仅删了 DLL 文件(如 my_udf.dll),但未执行 DROP FUNCTION,则函数名仍注册在数据字典中。此时任何用户调用该函数都会触发 mysqld 崩溃(SIGSEGV)——这是 MySQL 8.0 中已知的高危行为。
- 查出所有未绑定有效库文件的 UDF:
SELECT name, dl FROM mysql.func WHERE dl NOT IN (SELECT DISTINCT SUBSTRING_INDEX(file, '\', -1) FROM information_schema.PLUGINS WHERE plugin_type = 'FUNCTION'); - 对每个结果执行
DROP FUNCTION `name`;(反引号不可省) - Windows 下 DLL 路径大小写不敏感,但
dl字段值区分大小写;Linux 下需严格匹配.so文件名 - 不要依赖
SHOW FUNCTION STATUS,它不显示已丢失库的函数
回收插件关联的动态权限和角色
MySQL 8.0+ 插件(如 keyring_file、component_log_filter)可能在安装时自动授予 SYSTEM_USER、BACKUP_ADMIN 等动态权限,或创建专用角色(如 keyring_admin@localhost)。卸载后这些权限/角色不会自动撤销,构成隐蔽提权路径。
- 查插件相关角色:
SELECT role FROM mysql.role_edges WHERE role LIKE '%keyring%' OR role LIKE '%component%'; - 删角色:
DROP ROLE IF EXISTS `keyring_admin`@`localhost`; - 查用户被显式授予的插件权限:
SELECT grantee, privilege_type, is_grantable FROM role_tables_priv WHERE table_name = 'plugin' OR privilege_type LIKE '%KEYRING%'; - 逐个回收:
REVOKE SYSTEM_USER ON *.* FROM 'admin_user'@'%'; - 特别注意:
SYSTEM_VARIABLES_ADMIN和CLONE_ADMIN权限常被插件间接依赖,卸载后应重新审计
验证插件目录与配置项是否真正清空
MySQL 启动时会扫描 plugin_dir 目录加载插件,若残留旧插件文件(尤其同名不同版本的 .dll 或 .so),可能在未显式启用情况下被自动加载,造成非预期行为或日志污染。
- 查当前插件目录:
SELECT @@plugin_dir;,进入该路径检查是否有未识别的插件文件 - 检查配置文件(
my.ini或mysqld.cnf)中是否含plugin-load、early-plugin-load或keyring_file_data等残留配置行 - Windows 下常见残留路径:
C:ProgramDataMySQLMySQL Server 8.0plugin;Linux 下多见于/usr/lib/mysql/plugin/ - 若发现可疑文件,先停服务再删除;切勿在运行中直接删
plugin_dir下的活跃插件文件,会导致 mysqld 挂起
最易被忽略的是 UDF 函数残留——它不报错、不告警,只在某次特定 SQL 执行时让整个实例崩溃。务必把 mysql.func 表清理和 DROP FUNCTION 当作卸载插件后的强制收尾动作,而不是可选项。











