Liquibase SQL变更日志未用默认Schema致表找不到问题解决问询

问题 #

已在application.properties中配置默认Schema为MANAGER，且通过该配置成功创建了所有表；但在SQL变更日志中添加CHECK约束时，Liquibase无法找到未指定Schema的表（如STATUS表）。执行以下SQL语句时报错：

ALTER TABLE TEST ADD CONSTRAINT STATUS_ID CHECK (exists (SELECT 1 FROM STATUS s WHERE STATUS_ID = s.id))

错误信息：

Caused by: liquibase.exception.LiquibaseException: liquibase.exception.MigrationFailedException: Migration failed for change set changelog.xml::d::d:
Reason: liquibase.exception.DatabaseException: Таблица "STATUS" не найдена
Table "STATUS" not found; SQL statement:
ALTER TABLE TEST ADD CONSTRAINT STATUS_ID CHECK (exists (SELECT 1 FROM STATUS s WHERE STATUS_ID = s.id)) [42102-200]

相关配置：

RM_DB_SCHEMA: MANAGER
RM_DB_URL: "jdbc:h2:file:~/rmdb;MODE=PostgreSQL;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE;AUTO_SERVER=TRUE;INIT=CREATE SCHEMA IF NOT EXISTS ${RM_DB_SCHEMA}"
RM_DB_USER: sa
RM_DB_PASSWORD: admin
RM_LB_USER: ${RM_DB_USER}
RM_LB_PASSWORD: ${RM_DB_PASSWORD}
spring:
  datasource:
    hikari:
      schema: ${RM_DB_SCHEMA}
      username: ${RM_DB_USER}
      password: ${RM_DB_PASSWORD}
      jdbc-url: ${RM_DB_URL}
  liquibase:
    change-log: "classpath:db/manager-changelog.xml"
    default-schema: ${RM_DB_SCHEMA}
    user: ${RM_LB_USER}
    password: ${RM_LB_PASSWORD}
  jpa:
    database: postgresql

需要实现：让Liquibase在SQL变更日志中自动使用已配置的默认Schema。

解决方案 #

1. 显式指定Schema或使用变量替换 #

直接在SQL语句的表名前加上Schema前缀是最直接的解决方式：

ALTER TABLE MANAGER.TEST ADD CONSTRAINT STATUS_ID CHECK (exists (SELECT 1 FROM MANAGER.STATUS s WHERE STATUS_ID = s.id))

如果不想硬编码Schema名称，可在Liquibase变更日志中定义变量后引用，方便后续修改：

<property name="schema.name" value="${RM_DB_SCHEMA}"/>
<changeSet id="d" author="d">
    <sql>ALTER TABLE ${schema.name}.TEST ADD CONSTRAINT STATUS_ID CHECK (exists (SELECT 1 FROM ${schema.name}.STATUS s WHERE STATUS_ID = s.id))</sql>
</changeSet>

2. 强化默认Schema的配置 #

虽然已配置spring.liquibase.default-schema，但H2在PostgreSQL兼容模式下可能对会话默认Schema的识别存在偏差。可以通过两个步骤优化：

• 在变更日志的根节点显式指定默认Schema：

<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
                   http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.9.xsd"
                   defaultSchemaName="MANAGER">
    <!-- 变更集定义 -->
</databaseChangeLog>

• 修改JDBC URL，添加SET SCHEMA指令，强制会话启动时切换到指定Schema：

RM_DB_URL: "jdbc:h2:file:~/rmdb;MODE=PostgreSQL;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE;AUTO_SERVER=TRUE;INIT=CREATE SCHEMA IF NOT EXISTS ${RM_DB_SCHEMA};SET SCHEMA ${RM_DB_SCHEMA}"

3. 使用Liquibase内置约束创建标签 #

避免编写原生SQL，改用Liquibase提供的addCheckConstraint标签，它会自动应用配置的默认Schema：

<changeSet id="d" author="d">
    <addCheckConstraint tableName="TEST" constraintName="STATUS_ID"
                        checkConstraint="exists (SELECT 1 FROM STATUS s WHERE STATUS_ID = s.id)"/>
</changeSet>

这种方式下，Liquibase会自动为表名拼接默认Schema前缀，无需手动处理。

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