H2数据库配置启动报错：应用启动读表时遇问题求助

先别慌，我帮你拆解几个最常见的排查方向，你可以一步步来核对：

• 先盯紧连接字符串的细节
  虽然你没贴出具体字符串，但这是H2报错的重灾区：

  • 路径是否正确？如果是文件模式（jdbc:h2:file:开头），相对路径是相对于应用启动目录的，比如jdbc:h2:file:./data/mydb和jdbc:h2:file:/opt/app/data/mydb完全是两个位置，别搞混了。
  • 模式参数有没有匹配？比如你的表是用MySQL兼容语法建的，连接时没加;MODE=MYSQL，就会出现表结构识别、大小写敏感这类问题。
  • 有没有加;IFEXISTS=TRUE？这个参数会强制只连接已存在的数据库，避免误创建空库导致“表不存在”的错误。

• 检查数据库文件的状态

  • 如果是文件型H2库，先确认对应的.mv.db、.trace.db文件是否存在，路径和连接字符串里的完全一致吗？要是文件损坏，可以用H2自带的修复工具试试：java -cp h2*.jar org.h2.tools.Recover -db <你的数据库路径>。
  • 别误用内存模式！如果连接字符串是jdbc:h2:mem:开头，每次重启应用数据库都会清空，表数据自然读不到，这种情况赶紧改成文件模式持久化数据。

• 核对H2版本与依赖兼容性
  应用依赖的H2版本，和你当初用来创建表、初始化数据的H2版本是不是同一个？不同版本之间可能存在存储格式或语法差异，比如旧版本创建的库用新版本连接就容易报错。建议锁定一个稳定版本，比如1.4.200或者最新的稳定版。

• 验证表结构与初始化逻辑

  • 启动时建表脚本有没有正常执行？可以打开H2控制台（java -cp h2*.jar org.h2.tools.Console），用相同的连接字符串登录，直接查看有没有目标表存在。
  • 要是用了ORM框架（比如Spring Data JPA），检查ddl-auto配置：如果是create或create-drop，每次启动都会重建表，之前的数据肯定没了；改成validate或none才能保留已有表结构。

• 排查文件权限问题
  如果是Linux/macOS环境，数据库文件所在目录的权限是不是应用进程能访问的？比如目录是root所有，但应用用普通用户启动，就会出现“Permission denied”的错误，导致读不到数据库文件。

内容的提问来源于stack exchange，提问作者joesan