在跨服务器迁移、云端迁移或备份还原场景中，MySQL 的权限信息往往与数据分离处理。如果迁移过程只聚焦数据表的转移，而没有同步 mysql 数据库中的权限表，应用程序将无法以正确的用户身份访问数据库对象，从而出现连接失败、权限不足或功能受限的问题。
本篇围绕 MySQL迁移后权限丢失 的场景，系统梳理权限同步的多种方法，并给出排错步骤与可执行的代码示例，帮助你快速定位并恢复授权状态。
1.1 可能导致权限丢失的常见原因
1.1.1 权限表未同步或不完整
在迁移时如果只复制数据目录而忽略了 mysql.user、db、tables_priv、columns_priv、procs_priv、proxies_priv等权限表，将直接导致 用户及对象级、数据库级权限缺失，应用无法以原有账户执行操作。
此外，迁移工具或脚本若未覆盖权限表或在目标实例导入时遇到权限冲突，也会引发权限丢失的现象，因此要确保权限表被完整导出并正确导入。
1.1.2 新环境中的主机字段匹配问题
MySQL 的账户是用 用户-主机 组合来进行匹配的，因此 'user'@'host' 的主机部分差异会导致既有权限在新环境中失效，尤其是在从通配符 ('%') 到具体 IP 的迁移中尤为常见。
1.1.3 版本差异与权限表结构变化
不同 MySQL 版本对权限表的字段及权限模型存在差异，例如 MySQL 8 引入了角色和新的认证插件等机制，若直接把旧版本的 mysql.user 表导入新版本，可能出现结构不兼容的问题，需要执行 mysql_upgrade 来升级权限表结构。
2. 权限同步的总体思路与方案
2.1 基于系统表的直接同步
把源实例的权限表完整导出后在目标实例导入，是最直观的权限同步方式。涉及表 有 mysql.user、mysql.db、mysql.tables_priv、mysql.columns_priv、mysql.procs_priv、mysql.proxies_priv 等，确保覆盖所有权限层级。
-- 导出权限相关表（源服务器）
mysqldump -u root -p --no-create-info mysql user db tables_priv columns_priv procs_priv proxies_priv > mysql_privileges.sql
在目标实例执行导入后，务必执行 FLUSH PRIVILEGES 来让服务器重新加载权限表。
mysql -u root -p < mysql_privileges.sql
FLUSH PRIVILEGES;
如果目标环境是较新版本，执行 mysql_upgrade 以确保权限表结构与新版本兼容。
mysql_upgrade -u root -p --force
2.2 使用 GRANT 语句逐条重建权限
若无法直接同步权限表，另一种方式是通过获取源端的 GRANT 语句快照，逐条在目标端重建权限。首先在源实例对每个用户执行 SHOW GRANTS，再将结果在目标端执行。
GRANT ALL PRIVILEGES ON *.* TO 'admin'@'%' WITH GRANT OPTION;
GRANT SELECT, INSERT ON sales_db.* TO 'sales_user'@'192.168.1.100';
常用查询可以用来快速生成 GRANT 语句模板，例如查看某用户的所有权限：
SHOW GRANTS FOR 'sales_user'@'192.168.1.100';
3. 快速排错的步骤与命令
3.1 诊断入口：查看当前权限
在目标实例登录后，先检查实际生效的权限：SHOW GRANTS FOR 命令是最直接的入口，可以确认当前账户拥有的权限范围。
SHOW GRANTS FOR 'reader'@'%';
如果该输出与预期不符，说明权限未正确应用或未被导入覆盖。此时需要对比源端的权限快照并进行修复。
3.2 获取源端权限快照并对比
在源实例执行相同的 SHOW GRANTS，导出结果作为对照基准。通过比对，可以快速定位遗漏的对象或权限级别。
SHOW GRANTS FOR 'reader'@'192.168.1.200';
对比两端差异后，针对缺失的权限执行相应的 GRANT/REVOKE 操作，以达到对等状态。
GRANT SELECT ON sales_db.* TO 'reader'@'%' ;
REVOKE INSERT ON sales_db.* FROM 'reader'@'%';
3.3 常见问题与解答路径
排错时要关注认证插件、主机筛选、以及版本兼容性等因素。首先检查账户的认证插件与版本是否匹配：
SELECT user, host, plugin FROM mysql.user WHERE user = 'reader';
若发现插件不兼容，需根据版本特性调整账户设置，必要时重新设置密码插件或迁移策略。
4. 常用命令与代码片段
4.1 查看并导出权限
通过从 mysql.user 生成 SHOW GRANTS 的脚本，可以批量导出所有账户的授权语句，便于在目标端重建权限。
SELECT CONCAT('SHOW GRANTS FOR ''',user,'''@''',host,''';') AS sql_stmt
FROM mysql.user;
将输出的结果执行即可收集完整的授权语句快照。
4.2 导入权限并刷新
将导出的 GRANT 语句在目标实例执行并刷新权限，确保授权立即生效。
-- 在目标实例中执行导出的 GRANT 语句集合
SOURCE mysql_privileges.sql;
FLUSH PRIVILEGES;
4.3 常用 GRANT 语句模板
以下模板可用于快速构建常见的权限分配，注意替换数据库、账户与主机信息。
GRANT SELECT, UPDATE ON sales_db.* TO 'sales_user'@'%' IDENTIFIED BY 'secure_password';
GRANT ALL PRIVILEGES ON *.* TO 'admin'@'%' WITH GRANT OPTION;
5. 案例演练：迁移后权限丢失的排错示例
5.1 案例背景
某企业在从 MySQL 5.7 迁移到 8.0 的过程中心，未将 mysql 数据库中的权限表完整导出，导致应用程序在新环境中无法以原用户进行数据读取与写入。
5.2 操作要点
排错的核心步骤包括：先在源端导出权限表，再在目标端导入并执行 FLUSH PRIVILEGES，遇到版本差异时再运行 mysql_upgrade；随后通过 SHOW GRANTS 验证实际权限状况并进行必要的 GRANT 修复。
# 源实例：导出权限相关表
mysqldump -u root -p --no-create-info mysql user db tables_priv columns_priv procs_priv proxies_priv > privileges.sql# 目标实例：导入并刷新
mysql -u root -p < privileges.sql
FLUSH PRIVILEGES;# 版本兼容性检查
mysql_upgrade -u root -p --force
完成上述步骤后，使用 SHOW GRANTS FOR 验证目标账户的权限是否恢复到期望状态，并结合实际应用场景对必要对象的授权进行补充。
