SonarQube 8.9 → 9.9 升级过程：出现「SonarQube is under maintenance」维护页面完整解决方案

#问题来源#

综合了所有的现实系统考虑后，最后决定使用9.98版本，来满足现在的需求，结果又卡壳了。。。。一波三折

背景：

将8.9版本的数据从PG10导出后，直接导入9.9对应的PG14A版本，，使用pg_dumall，导出的sql，导入后，启动服务一直停留在维护页面，停留了一夜

这个页面代表 SonarQube 正在执行数据库迁移升级，属于版本跨代升级必经流程： 8.9（LTS）升级至 9.9（LTS）会自动触发数据库结构变更，服务会进入维护锁状态，禁止用户访问，迁移完成后页面自动恢复。

不要刷新、不要重启服务，等待后台执行数据库迁移；
查看 SonarQube 日志目录 sonarqube/logs/sonar.log，观察日志关键词：
- Executing migration step：正在执行表结构、索引、数据迁移
- Migration completed：迁移完成，页面会自动退出维护模式
迁移耗时取决于数据库数据量：
- 小项目（十万行代码内）：5--30 分钟
- 大量历史项目、千万级扫描记录：1--4 小时都正常

数据库版本
- PostgreSQL ≥9.6（推荐 13+）；MySQL/Oracle 部分旧版本不再支持若使用 MySQL，9.9 已大幅限制兼容，推荐切换 PostgreSQL
Java 运行环境 SonarQube 9.9 必须使用 Java 17，不能沿用 8.9 的 Java11，否则迁移直接崩溃
磁盘空间 数据库磁盘预留至少原库 30% 空闲空间，迁移会生成临时表 / 备份数据
插件兼容 8.9 旧插件大多不兼容 9.9，升级前全部移除 extensions/plugins 目录下第三方插件，升级完成后再安装适配 9.9 的新版插件

日志出现 permission denied for table 解决：给 SonarQube 数据库账号授予 ALTER, CREATE, DROP, INDEX, REFERENCES 全部权限。

日志 OutOfMemoryError 修改 sonarqube/conf/sonar.properties 调整 JVM 参数：

复制代码

# 迁移阶段调高内存
sonar.web.javaOpts=-Xmx4G -Xms2G
sonar.ce.javaOpts=-Xmx4G -Xms2G
sonar.search.javaOpts=-Xmx2G -Xms1G

修改后重启 SonarQube，会继续上次未完成的迁移。

只有确认数据库迁移完全失败且回滚备份后才能执行：

bash 复制代码

UPDATE properties SET text_value='' WHERE kee='sonar.core.maintenance.lock';

警告：迁移中途执行此操作会直接损坏数据库，仅回滚备份后使用！

install SonarLint in your IDE 维护等待期间可提前在本地 IDE 安装 SonarLint，本地实时扫描替代等待服务恢复。
read the upgrade guide 官方升级文档：专门说明跨 LTS 版本（8.9→9.9）数据库迁移、兼容性、回滚方案，出现异常优先查阅官方升级指南。

综合定位是数据库库的权限没有给足，很奇怪，原来的导出的脚本中有sonarqube用户的授权等信息，解决后问题还是没有解决，接着继续定位