桌面版 ODC 启动失败/h2数据库损坏 Chuck not found

问题现象

桌面版 ODC 启动失败，报错日志中提示："java.lang.IllegalStateException: Chunk *** not found"。

问题原因

桌面版 ODC 的 h2database 元数据库损坏，具体请参考 GitHub 的 IllegalStateException: Chunk not found in v1.4.200/9 和 Cursor sporadically fail with 'IllegalStateException: Chunk {number} not found'。

解决方法

修复元数据库文件。

步骤 1： 下载恢复工具

下载并安装恢复工具。

步骤 2：生成恢复 SQL 语句

1. 查看元数据文件路径。桌面版 ODC 的元数据维护在嵌入式数据库 h2database 中：

   • Windows 系统下的数据文件路径 %USERPROFILE%\AppData\Roaming\odc\。

     修复元数据库文件。

     cd %USERPROFILE%\AppData\Roaming\odc\
     

   • MacOS 系统下的数据文件路径 /Users/{user}/Library/Application Support/odc。

     cd ~/"Library/Application Support/odc" 
     ls odc*.db
     
     #查看以下 2 个文件，即 h2database 数据库对应的数据文件
     #odc2.0.mv.db    odc2.0.trace.db
     

2. 将损坏的 ODC 元数据库文件 odc2.0.mv.db拷贝至 h2\bin\路径下。

3. 进入 cmd 执行 java -cp h2-1.4.200.jar org.h2.tools.Recover，路径下会生成 odc2.0.h2.sql，如下图所示。

   

步骤 3：执行恢复 SQL 语句

1. 生成新的数据库 odc2.1。参考命令如下：

   java -cp h2-1.4.200.jar org.h2.tools.RunScript -url jdbc:h2:./odc2.1 -user sa -password '' -script odc2.0.h2.sql
   

2. 执行完成后，路径下会产生文件 odc2.1.mv.db。

步骤 4：拷贝恢复的数据库文件至 ODC 安装路径

1. 将 odc2.1.mv.db文件拷贝至元数据库文件所在路径下，并将其重命名为 odc2.0.mv.db。

2. 重启 ODC。