指定liquibase-schema/default-schema时出现databasechangeloglock不存在错误

问题现象 #

• 不配置spring.liquibase.liquibase-schema和spring.liquibase.default-schema时，程序正常运行，所有表（包括Liquibase自带的databasechangelog、databasechangeloglock）都生成在默认schema里。
• 一旦把这两个属性设为自定义schema（比如xxx），启动就会报错：relation "xxx.databasechangeloglock" does not exist。

核心原因 #

1. 目标schema未提前创建：Liquibase不会自动帮你创建指定的schema，它会直接去你指定的liquibase-schema下查找锁表，但这个schema本身不存在，自然会抛出找不到表的错误。
2. 数据库账号权限不足：连接数据库的账号没有创建schema或者访问目标schema的权限，导致Liquibase无法在指定位置初始化锁表。

解决办法 #

1. 提前手动创建schema #

启动应用前，用数据库客户端执行创建schema的SQL，不同数据库语法略有差异：

• PostgreSQL：

CREATE SCHEMA IF NOT EXISTS xxx;

• MySQL：

CREATE DATABASE IF NOT EXISTS xxx;

• Oracle：需先创建用户并分配对应权限

2. 配置Liquibase自动创建schema（限部分数据库） #

在配置文件中添加以下属性，让Liquibase尝试自动创建schema（仅PostgreSQL、H2等数据库支持，MySQL/Oracle可能不兼容）：

spring.liquibase.parameters.schema=xxx
spring.jpa.properties.hibernate.default_schema=xxx

注意要确保数据库连接账号拥有创建schema的权限。

3. 给数据库账号补充权限 #

以PostgreSQL为例，给账号分配目标schema的全权限：

GRANT ALL PRIVILEGES ON SCHEMA xxx TO your_db_user;

确保账号能在目标schema下执行建表、读写数据等操作。

4. 简化配置避免冲突 #

如果不需要分离Liquibase自身表和业务表的存储位置，只配置default-schema即可，不用单独设置liquibase-schema，这样所有表（包括Liquibase锁表）都会统一生成在指定的schema中，减少配置冲突。

内容的提问来源于stack exchange，提问作者Cui Pengfei 崔鹏飞