EXPLAIN返回空或报错主因是权限不足:缺PROCESS权限会导致ERROR 1227,缺SELECT/SHOW VIEW权限引发ERROR 1142,MySQL 8.0+还需SYSTEM_VARIABLES_ADMIN等新权限,且performance_schema表需单独授权。

为什么EXPLAIN返回空或报错,其实是权限不足
当你执行 EXPLAIN SELECT ... 却看到空结果、NULL 输出,或报错 ERROR 1227 (42000): Access denied; you need (at least one of) the PROCESS privilege(s) for this operation,这不是SQL写错了,而是当前用户缺少 PROCESS 权限。MySQL 5.7+ 默认禁止普通用户查看执行计划细节,尤其涉及 performance_schema 或线程状态时。
常见场景包括:DBA给了 SELECT 权限但没给 PROCESS;应用账号用只读账号连接,无法运行诊断命令;运维脚本自动收集执行计划失败却误判为SQL语法问题。
- 检查权限:登录后执行
SHOW GRANTS FOR CURRENT_USER;,确认输出中是否含PROCESS - 临时补权(仅限调试):
GRANT PROCESS ON *.* TO 'your_user'@'%'; FLUSH PRIVILEGES; - 生产环境慎用:该权限可查看所有连接的SQL和状态,暴露敏感信息,不建议长期开放给应用账号
slow_query_log 开启失败却提示“权限不足”,但你明明有 SUPER
执行 SET GLOBAL slow_query_log = ON; 报 ERROR 1227,即使你确认有 SUPER 权限,也要注意 MySQL 8.0.16+ 引入了更细粒度的权限模型:SUPER 已被弃用,取而代之的是 SYSTEM_VARIABLES_ADMIN 和 PERSIST_RO_VARIABLES_ADMIN(若使用 PERSIST 写配置文件)。
这会导致老运维脚本在升级后突然失效——不是权限漏配,而是权限名变了。
- 验证当前所需权限:
SELECT * FROM performance_schema.role_table_grants WHERE ROLE_NAME = 'your_role';(如用角色管理) - MySQL 8.0+ 正确授权:
GRANT SYSTEM_VARIABLES_ADMIN ON *.* TO 'admin_user'@'%'; - 如果用
SET PERSIST slow_query_log = ON;,还需额外PERSIST_RO_VARIABLES_ADMIN - my.cnf 配置不受此限制,但重启才生效,无法用于快速线上诊断
为什么 pt-query-digest 解析慢日志总报 “Permission denied”
pt-query-digest 默认尝试读取 /var/lib/mysql/localhost-slow.log,但它是在 shell 层面以运行用户(比如 mysql 或 root)身份访问文件系统。即使 MySQL 内部已开启慢日志,OS 层级的文件权限可能完全阻止外部工具读取。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
典型现象:MySQL 能正常写日志,tail -f /var/lib/mysql/localhost-slow.log 却提示 permission denied;pt-query-digest 报错末尾是 Cannot open /var/lib/mysql/localhost-slow.log: Permission denied。
- 确认日志路径:
SHOW VARIABLES LIKE 'slow_query_log_file'; - 检查文件属主与权限:
ls -l $(mysql -Nse "SELECT @@slow_query_log_file") - 安全做法:不要直接
chmod 644日志文件(存在审计风险),改用setfacl -m u:percona:r /var/lib/mysql/localhost-slow.log(若支持 ACL) - 更稳妥方案:把日志输出到表(
SET GLOBAL log_output = 'TABLE';),再用SELECT导出,绕过文件系统权限
用 performance_schema 查 events_statements_history 却查不到慢查询
执行 SELECT * FROM performance_schema.events_statements_history ORDER BY TIMER_END DESC LIMIT 10; 返回空或只有极短耗时记录,不是数据没发生,而是当前用户没有 SELECT 权限访问 performance_schema 库下的对应表,或者该库未启用监控采集。
MySQL 默认关闭部分 performance_schema 表的采集(如 events_statements_history 的大小和开关是独立控制的),且 8.0+ 默认不授予普通用户访问权限。
- 先确认采集是否开启:
SELECT * FROM performance_schema.setup_consumers WHERE NAME = 'events_statements_history';,ENABLED必须为YES - 确认表是否启用:
SELECT * FROM performance_schema.setup_instruments WHERE NAME LIKE 'statement/%' AND ENABLED = 'YES' LIMIT 3; - 授予权限:
GRANT SELECT ON performance_schema.events_statements_history TO 'dev_user'@'%'; - 注意:该表是环形缓冲区,默认只保留最近 10000 条,高频业务下容易被覆盖,需配合
events_statements_summary_by_digest查聚合统计
权限问题在慢查询排查中常被当作“环境配置问题”跳过,但它实际会直接切断诊断链路——EXPLAIN 看不到执行计划、pt-query-digest 读不了日志、performance_schema 查不到历史,表面是工具失效,根因往往是权限颗粒度变细后没同步更新。尤其在 MySQL 8.0+ 环境下,SUPER 权限的语义迁移和 performance_schema 的默认关闭策略,最容易在升级后引发“一切看起来都配好了,但就是查不到慢 SQL”的情况。

















