我要评论在将 spring boot 项目升级至 3.x，并配套引入 flyway（10.x / 11.x）进行数据库版本迁移管理时，许多使用独立业务账号连接 mysql 8.0+ 的开发者会遇到一个隐蔽的启动异常：
java.sql.sqlsyntaxerrorexception: select command denied to user 'breedingbox'@'localhost' for table 'user_variables_by_thread'
许多人第一反应会怀疑是 jdbc 驱动版本不兼容（例如使用了较新的 mysql connector/j 9.x）或者 spring boot 配置写错。然而深入排查后会发现，这是一个典型的 “自动化迁移框架底层探测机制” 与 “mysql 8.0 权限安全模型” 碰撞 产生的问题。
一、 根因溯源：谁在偷偷查这张表？
1. 为什么排查焦点会误判为驱动？
报错信息由 mysql connector/j 抛出，同时发生在应用启动建立数据库连接的第一时间。随着 mysql connector/j 9.x 发布，很多开发者会怀疑新驱动引入了破坏性变更。
但实际上，驱动只是搬运工，真正发起查询的是 flyway。
2. flyway 的变量保护机制
在新版 flyway（尤其是 10+ 与 11+）适配 mysql 时，为了保证数据库迁移脚本在执行前后的环境纯净，flyway 会尝试捕获并管理会话级用户变量（user-defined variables）。
在 mysql 中，这些会话级变量的元数据被存放在系统性能字典表：
performance_schema.user_variables_by_thread
flyway 在启动初始化或执行迁移时，会主动向数据库发送类似如下的探测语句：
select * from performance_schema.user_variables_by_thread;
3. mysql 8.0+ 的权限收紧
在 mysql 5.7 时代，权限体系相对宽松；而在 mysql 8.0+ 中，系统对 performance_schema 库实施了更严格的权限隔离：
- 开发者通常为业务应用创建专用账号（如
breedingbox），并通过grant all privileges on breedingbox.* to ...授予业务库权限。 - 但是，
performance_schema不在业务库的作用域内，非root的普通用户默认对performance_schema.user_variables_by_thread没有任何读取权限。
当 flyway 尝试读取该表时，mysql 服务端直接拦截并抛出 select command denied。
二、 驱动要不要降级？
结论：完全不需要。
- 向后兼容性：mysql 官方 connector/j 9.x 对 mysql 8.0 保持了良好的向下兼容，并原生支持 jdk 17/21 与 spring boot 3.x 运行时。
- 降级无法解决问题：即使将驱动降级至 8.0.x，由于查询发起方是 flyway 自身的核心逻辑，该 sql 依然会被执行，报错依旧。
三、 解决方案与最佳实践
方案 1：授予指定表的只读权限（官方推荐 & 最彻底）
遵循最小权限原则（principle of least privilege），无需给应用账号开放整个 performance_schema，仅开放该表的 select 权限即可。
以 root 或高权限管理员身份登录 mysql，执行以下命令：
-- 1. 授予指定表的读取权限（根据实际 host 填写 localhost 或 %） grant select on performance_schema.user_variables_by_thread to 'breedingbox'@'localhost'; -- 2. 刷新权限使其立即生效 flush privileges;
注意：如果应用运行在 docker 容器、k8s 集群或跨机器部署，连接主机通常为远程 ip，需将 'breedingbox'@'localhost' 替换为 'breedingbox'@'%'。
方案 2：无法获取 root 权限时的临时应急方案
在某些企业受管数据库（如云厂商 rds/企业只读从库）中，开发者可能无法获取 root 权限去执行 grant。此时可以通过调整 jdbc 参数关闭部分探测行为：
在 application.yml 的数据库连接串中追加 trackslavebyhost=false：
spring:
datasource:
url: jdbc:mysql://localhost:3306/breedingbox?useunicode=true&characterencoding=utf8&servertimezone=asia/shanghai&usessl=false&allowpublickeyretrieval=true&trackslavebyhost=false
driver-class-name: com.mysql.cj.jdbc.driver四、 总结
| 维度 | 详情 |
| 报错现象 | select command denied for table 'user_variables_by_thread' |
| 触发组件 | flyway 10/11 执行会话变量探测 |
| 根本原因 | mysql 8.0+ 默认未向普通业务账号开放 performance_schema 查询权限 |
| 驱动影响 | 无关，无需更换/降级 mysql-connector-j |
| 最佳解法 | 管理员账号执行 grant select on performance_schema.user_variables_by_thread to 'user'@'host'; |
框架升级带来的底层行为变更往往十分隐蔽。在引入 flyway 或 liquibase 等基础设施组件时，除了分配业务库（schema）本身的 ddl/dml 权限，也需要留意框架在系统元数据层面的权限依赖。
以上就是springboot3 + flyway启动暴雷的原因与解决方案的详细内容，更多关于springboot3 flyway启动暴雷的资料请关注代码网其它相关文章！
发表评论