无法通过Server模式连接H2数据库 报JDBC DDL执行连接错误

• 场景：Java应用使用文件存储模式的H2数据库，因IntelliJ存在数据显示异常问题，未采用内存模式。
• application.properties中数据源URL配置如下：

spring.datasource.url=jdbc:h2:file:~/test-db;
    DB_CLOSE_DELAY=-1;DATABASE_TO_UPPER=false;AUTO_SERVER=TRUE

• 通过IntelliJ、H2控制台使用如下URL可正常连接并查看表数据：

jdbc:h2:file:~/test-db

• DBeaver中提示数据库连接成功，但无法查看表数据。
• 尝试使用TCP参数以Server模式连接H2，使用以下两类配置均连接失败，Windows操作系统下抛出Unable to open JDBC Connection for DDL execution错误：

spring.datasource.url=jdbc:h2:tcp://localhost/~/test-db

jdbc:h2:tcp://localhost/C:/test-db 

文件模式连接（推荐，无需额外启动服务） #

连接成功但看不到表是配置不匹配导致，按以下步骤调整即可：

• 驱动版本完全对齐：DBeaver使用的H2 JDBC驱动版本，必须和SpringBoot项目引入的H2依赖版本一致。H2小版本间存储格式不兼容，版本偏差会导致元数据读取异常、表列表为空。
• 补全连接参数，使用绝对路径：Windows下不要用~写相对路径，避免DBeaver与Java应用识别的用户目录不一致，连接到空白新库。DBeaver连接URL填写如下内容，替换路径中用户名为本机Windows登录账号名：

jdbc:h2:file:C:/Users/你的Windows用户名/test-db;DB_CLOSE_DELAY=-1;DATABASE_TO_UPPER=false;AUTO_SERVER=TRUE

必须携带DATABASE_TO_UPPER=false参数：该参数关闭H2自动转大写表名/字段名的逻辑，缺省该参数时，DBeaver读取大写元数据会和实际创建的小写命名表不匹配，直接导致表列表为空。

• 清理DBeaver本地缓存：右键连接选择刷新，无效则删除旧连接重建，清空历史元数据缓存；连接设置中将默认Schema指定为PUBLIC（H2默认用户Schema，未手动修改时所有业务表均存放在该Schema下），关闭自定义表过滤规则。

TCP模式连接报错修复 #

TCP模式连接失败的核心原因是未提前启动H2 TCP服务，直接修改URL会触发连接拒绝：

• 启动H2 TCP服务：找到本地Maven仓库内对应版本的H2 jar包，在jar包所在目录执行命令，替换命令内的jar包版本、baseDir路径为本地实际值：

java -cp h2-1.4.200.jar org.h2.tools.Server -tcp -tcpAllowOthers -tcpPort 9092 -baseDir C:/Users/你的Windows用户名/

• 服务启动后使用如下URL连接，同样携带大小写参数：

jdbc:h2:tcp://localhost:9092/test-db;DATABASE_TO_UPPER=false

• 若Java应用正在占用数据库文件，必须保证应用侧配置了AUTO_SERVER=TRUE，否则会触发文件锁冲突导致连接失败。

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