R2DBC 与 Liquibase 集成问题：表未找到的解决方案

本文旨在解决在使用 Spring Boot R2DBC 集成 Liquibase 时遇到的 “Table not found” 异常。通常，这个问题源于 R2DBC 和 Liquibase 配置之间的冲突，以及二者对数据库连接方式的不同处理。本文将深入探讨问题原因，并提供切实可行的解决方案，帮助开发者成功地将 Liquibase 集成到 R2DBC 项目中，并确保数据库模式的正确初始化。 ### 问题分析 在使用 Spring Boot 2.7.x 及以上版本时，直接在 WebFlux 应用中同时启用 Liquibase 和 R2DBC 可能会遇到问题。这是因为 Liquibase 是基于阻塞的 JDBC API 构建的，而 R2DBC 则是非阻塞的响应式 API。Spring Boot 的自动配置机制可能会导致两者之间的冲突。 具体表现为： * 即使 Liquibase 成功执行了数据库变更脚本，R2DBC 仍然无法找到相应的表。 * 应用程序日志显示 Liquibase 成功创建了表，但 R2DBC 抛出 “Table not found” 异常。 ### 解决方案 解决此问题的关键在于正确配置 R2DBC 和 Liquibase，并确保它们使用相同的数据库连接信息。以下是一些可行的解决方案： 1. **检查配置属性前缀：** 确保 R2DBC 的配置属性使用 `spring.r2dbc` 前缀，例如： “`yaml spring: r2dbc: url: r2dbc:h2:mem:///testdb;DB_CLOSE_DELAY=-1; username: sa password: password

同时，Liquibase 的配置属性使用 `spring.liquibase` 前缀：  ```yaml spring:   liquibase:     url: jdbc:h2:mem:///testdb     user: sa     password: password     change-log: classpath:db.changelog/db.changelog-master.yaml     enabled: true ```  **注意:** 确保 `spring.r2dbc.url` 和 `spring.liquibase.url` 指向同一个数据库实例。

2. 使用 r2dbc migrate：

   作为 Flyway 或 Liquibase 的替代方案，可以考虑使用 R2DBC Migrate。R2DBC Migrate 是一个专门为 R2DBC 设计的数据库迁移工具，它遵循与 Flyway 类似的文件模式，并且与 WebFlux 应用完全兼容。

   要使用 R2DBC Migrate，首先需要在项目中添加相应的依赖：

   <dependency>     <groupId>com.github.nkonev</groupId>     <artifactId>r2dbc-migrate</artifactId>     <version>最新版本</version> </dependency>

   然后，将数据库迁移脚本放置在 src/main/resources/db/migration 目录下，并按照 R2DBC Migrate 的规范进行编写。

3. 确保 Liquibase 运行在正确的上下文中：

   如果使用 Liquibase，请确保它在测试环境中正确运行，并且能够访问到 H2 数据库。检查 db.changelog-master.yaml 和 db.changelog-1.0.sql 文件，确保它们包含正确的数据库变更脚本，并且脚本能够成功执行。

   例如，db.changelog-1.0.sql 文件应该包含以下内容：

   --liquibase formatted sql  --changeset deniskaydunov:1 CREATE TABLE IF NOT EXISTS public.event (     seq SERIAL PRIMARY KEY,     type VARCHAR (32) NOT NULL,     id VARCHAR (32) NOT NULL,     received TIMESTAMP NOT NULL );  --changeset deniskaydunov:2 contextFilter:test INSERT INTO public.event (type, id, received) VALUES ('IRS', '123', '2018-02-05 11:59:19');

   请注意，contextFilter:test 确保只有在 test profile 激活时，才会执行 INSERT 语句。

4. 显示指定schema:

   H2数据库默认使用PUBLIC schema，但有些情况下需要显示指定。可以在R2DBC连接URL中指定schema：

   spring:   r2dbc:     url: r2dbc:h2:mem:///testdb;DB_CLOSE_DELAY=-1;SCHEMA=PUBLIC     username: sa     password: password

注意事项

• 确保 R2DBC 和 Liquibase 使用相同版本的 H2 数据库驱动。
• 在测试环境中，建议使用内存数据库 (如 H2) 来加快测试速度。
• 仔细检查应用程序日志，以确定问题的根本原因。

总结

在使用 Spring Boot R2DBC 集成 Liquibase 时，需要特别注意配置属性的前缀、数据库连接信息以及 Liquibase 的运行上下文。通过正确配置 R2DBC 和 Liquibase，或者使用 R2DBC Migrate 等替代方案，可以有效地解决 “Table not found” 异常，并确保数据库模式的正确初始化。