使用WebFlux与Reactive H2 Database时H2 UI无法登录求助

以下是针对性的排查和解决步骤：

1. 确认H2依赖配置完整 #

确保项目依赖中同时包含H2核心驱动和响应式数据库客户端，不要只引入R2DBC依赖而遗漏H2驱动：

Maven配置示例： #

<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-r2dbc</artifactId>
</dependency>

Gradle配置示例： #

runtimeOnly 'com.h2database:h2'
implementation 'org.springframework.boot:spring-boot-starter-data-r2dbc'

2. 修正H2控制台的JDBC URL格式 #

H2控制台仅支持标准JDBC连接串，不能使用R2DBC格式的URL：

• 内存数据库正确URL：jdbc:h2:mem:testdb（前缀为jdbc:而非r2dbc:）
• 文件数据库正确URL：jdbc:h2:file:./data/testdb

如果填入r2dbc:h2:mem:///testdb这类响应式连接串，会直接触发“找不到驱动”的错误。

3. 核对H2控制台与R2DBC配置 #

确保应用配置中，H2控制台和R2DBC的参数各自正确：

application.yml示例： #

spring:
  h2:
    console:
      enabled: true
      path: /h2-console
  r2dbc:
    url: r2dbc:h2:mem:///testdb
    username: sa
    password:

注意：spring.r2dbc.url是给应用程序使用的响应式连接串，H2控制台需要单独填写JDBC格式的URL。

4. 匹配H2与Spring Boot版本兼容性 #

Spring Boot 3.x需搭配H2 2.x版本，Spring Boot 2.x对应H2 1.x版本，版本不兼容会导致驱动加载失败。

5. 清理缓存并重启 #

• 执行mvn clean install（Maven）或gradle clean build（Gradle）清理依赖缓存
• 重启IDE和应用程序，避免类加载器缓存导致的驱动无法识别问题

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