MySQL 8.0.1+才支持角色,ERROR 1064说明版本过低;ERROR 3719需启用角色功能并授权ROLE_ADMIN;GRANT权限给角色和GRANT角色给用户须分两步;SET DEFAULT ROLE才能激活权限;角色名必须用单引号。

CREATE ROLE 报错 ERROR 1064 或 ERROR 3719 怎么办
直接执行 CREATE ROLE 就报错,基本不是语法问题,而是环境没达标。
出现 ERROR 1064:说明 MySQL 版本低于 8.0.1 —— 角色功能从这个版本才正式引入。运行 SELECT VERSION(); 确认,若输出是 5.7.32 或类似,就别用角色,老实用 GRANT SELECT ON db.* TO 'u'@'%';。
出现 ERROR 3719(提示 'role_admin'@'%' is not set as a role):说明角色支持未启用。必须由 root 或高权限用户先执行:
SET GLOBAL activate_all_roles_on_login = ON;GRANT ROLE_ADMIN ON *.* TO 'admin_user'@'%';FLUSH PRIVILEGES;
重启不生效?在 my.cnf 的 [mysqld] 段加一行:activate_all_roles_on_login=ON。
GRANT 权限给角色 vs GRANT 角色给用户,两步不能跳
很多人以为“给角色授了权,再把角色给用户”,权限就自动生效了——其实这是两个独立动作,缺一不可,且顺序不能反。
- 第一步(填充角色):
GRANT SELECT, INSERT ON app.* TO 'app_writer';—— 这是对角色本身赋权,对象是角色名(带单引号),不是用户 - 第二步(绑定用户):
GRANT 'app_writer' TO 'dev_user'@'%';—— 这只是建立关联,mysql.role_edges表里多一条记录,但用户登录后仍无权限
注意:GRANT 给角色时不能加 IDENTIFIED BY;角色名含 - 或 .(如 ci-pipeline),必须用反引号:GRANT SELECT ON logs.* TO `ci-pipeline`;。
SET DEFAULT ROLE 是权限生效的临门一脚
执行完前两步后,用户登录仍被拒,SELECT CURRENT_ROLE(); 返回 NULL,问题几乎一定出在这步没做。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
-
SET DEFAULT ROLE 'app_writer' TO 'dev_user'@'%';—— 让该用户每次连接自动激活指定角色(注意 host 必须精确匹配,'dev_user'@'%'不能对'dev_user'@'localhost'设默认角色) - 普通用户无法自行执行
SET DEFAULT ROLE,需管理员具备APPLICATION_PASSWORD_ADMIN或SYSTEM_VARIABLES_ADMIN权限 -
SET DEFAULT ROLE ALL TO 'dev_user'@'%';会激活所有已授予角色,但违背最小权限原则,慎用
角色不支持列级授权:GRANT SELECT(col1) ON t1 TO 'r1'; 会直接报错;系统级权限可授给角色(如 CREATE, DROP ON *.*),但加 WITH GRANT OPTION 会报 ERROR 3529;要用 WITH ADMIN OPTION 控制角色分发权。
角色名必须用单引号,写错就语法报错
创建或引用角色时,角色名必须用单引号包裹,比如 'app_reader'。
写成反引号 `app_reader` 或双引号 "app_reader" 都可能触发语法错误,MySQL 会把它当成标识符或字符串字面量处理,而不是角色名。
尤其在 GRANT ... TO 'role_name'; 和 SET DEFAULT ROLE 'role_name' TO ...; 这类语句中,单引号是硬性要求。漏掉或换错引号类型,就是最常见、最隐蔽的“明明照着文档抄却不行”的原因。
真正容易被忽略的是:角色本身不携带身份认证能力,它只是权限容器;用户是否能用某个角色,取决于三件事是否全部满足——角色存在、角色已授予权限、角色已通过 SET DEFAULT ROLE 激活。少一个环节,权限就悬在半空。










