WSO2 ESB启动异常：H2数据库删除索引行失败求助

我之前维护WSO2 ESB时刚好碰到过一模一样的问题——启动直接报错org.h2.jdbc.JdbcSQLException: Row not found when trying to delete from index，确实是H2数据库的索引或底层数据损坏导致的，重启完全没用，得手动处理才行。下面是我亲测有效的几个解决办法，按优先级尝试：

方案1：尝试修复损坏的H2数据库 #

这是首选方案，能尽量保留现有数据：

• 先彻底停止WSO2 ESB服务，确保没有任何进程在占用数据库文件（可以用ps命令或任务管理器确认）
• 找到ESB的H2数据库存储路径，默认是<ESB安装目录>/repository/database
• 下载对应你ESB版本的H2数据库客户端工具（版本一定要匹配，不然可能连不上），启动H2控制台：
  • 在控制台的JDBC URL输入框里，填写指向你损坏数据库的路径，比如：jdbc:h2:/opt/wso2esb-6.6.0/repository/database/WSO2CARBON_DB
  • 用户名和密码默认都是wso2carbon，点击连接
• 连接成功后，执行修复命令：

  SHUTDOWN COMPACT;
  

  这个命令会整理数据库文件、修复损坏的索引和数据块
• 执行完成后关闭H2控制台，重新启动WSO2 ESB，看看是否能正常启动

方案2：替换为干净的H2数据库文件（修复无效时） #

如果修复后还是报错，说明数据损坏太严重，只能用全新的数据库文件替换：

• 停止WSO2 ESB服务，一定要备份当前的<ESB_HOME>/repository/database目录（万一后续需要恢复旧数据里的配置）
• 删除该目录下所有H2相关的文件（比如.mv.db、.trace.db这类后缀的文件）
• 从一个同版本的全新WSO2 ESB安装包中，复制<新ESB_HOME>/repository/database下的所有文件到你的ESB对应目录
• 启动ESB，此时会初始化一个干净的数据库，但要注意：你之前部署的服务、租户配置等数据会丢失，所以如果有重要数据，建议提前通过ESB的导出功能把配置导出，之后再重新导入

方案3：调整H2配置预防后续问题 #

为了避免以后再出现这类损坏问题，可以优化H2的配置：

• 打开<ESB_HOME>/repository/conf/datasources/master-datasources.xml
• 找到H2数据源的配置项，在JDBC URL中添加LOCK_MODE=0参数，示例：

  <url>jdbc:h2:repository/database/WSO2CARBON_DB;DB_CLOSE_ON_EXIT=FALSE;LOCK_MODE=0</url>
  

  这个参数会调整H2的锁机制，降低并发访问导致的索引损坏概率
• 另外强烈建议：生产环境不要使用H2数据库，H2更适合开发测试场景，生产环境换成MySQL、PostgreSQL这类企业级数据库，稳定性和可靠性会高很多

内容的提问来源于stack exchange，提问作者Muralidharan.rade