Liquibase忽略PostgreSQL系统目录pg_catalog的技术问题求助

我很理解你遇到的困扰——明明用超级用户权限指定了pg_catalog作为目标schema，Liquibase却生成了空的变更日志，这大概率是因为Liquibase内置了系统对象过滤机制，默认会跳过PostgreSQL的系统schema（包括pg_catalog、information_schema），不管你有没有显式指定。

下面是具体的原因分析和解决办法：

原因：Liquibase的默认系统对象过滤 #

Liquibase自带SystemObjectFilter，它的核心逻辑就是自动识别并排除数据库的系统级对象和schema。即使你在buildCatalogAndSchema里指定了pg_catalog，这个过滤器也会在diff和变更日志生成的环节把这些对象过滤掉，导致最终输出空的databaseChangeLog数组。

解决方案：自定义ObjectFilter绕过过滤 #

要让Liquibase处理pg_catalog的对象，你需要覆盖默认的过滤规则，实现一个自定义的ObjectFilter来允许pg_catalog的对象通过。

1. 实现自定义过滤器 #

创建一个简单的过滤器类，明确允许pg_catalog的schema和其中的对象：

class AllowPgCatalogFilter implements ObjectFilter {
    @Override
    public boolean include(Object object, Database database) {
        // 处理Schema对象：允许pg_catalog和非系统schema
        if (object instanceof Schema) {
            Schema schema = (Schema) object;
            return "pg_catalog".equals(schema.getName()) || !schema.isSystem();
        }
        // 处理其他数据库对象：检查所属schema是否是pg_catalog或非系统schema
        if (object instanceof DatabaseObject) {
            DatabaseObject dbObj = (DatabaseObject) object;
            Schema schema = dbObj.getSchema();
            return schema == null || "pg_catalog".equals(schema.getName()) || !schema.isSystem();
        }
        // 默认允许其他对象
        return true;
    }
}

2. 在生成变更日志前设置过滤器 #

在你调用generateChangeLog之前，把这个自定义过滤器绑定到你的Database对象上：

// 获取当前Database实例
Database database = this.liquibase.getDatabase();
// 设置自定义过滤器
database.setObjectFilter(new AllowPgCatalogFilter());

// 执行原有的generateChangeLog逻辑
this.liquibase.generateChangeLog(
    buildCatalogAndSchema(database),
    new DiffToChangeLog(new DiffOutputControl(false, false, false, null)),
    new PrintStream(new FileOutputStream(this.changeLog)),
    ChangeLogSerializerFactory.getInstance().getSerializer(this.changeLog),
    Optional.of(DatabaseObjectFactory.getInstance()
        .parseTypes(this.diffTypes))
        .map(s -> s.toArray(new Class[s.size()]))
        .get()
);

额外注意事项 #

• 即使绕过了过滤，pg_catalog里的部分系统对象（比如内置函数、系统表的特殊约束）可能仍然无法被Liquibase正确解析或生成变更日志，因为Liquibase的核心设计目标是处理用户自定义的schema和对象，而非系统级对象。
• 可以再验证一下超级用户的权限：执行SELECT * FROM pg_catalog.pg_tables WHERE schemaname='pg_catalog';，确认能正常返回数据，确保权限没有问题。
• 建议升级到Liquibase的最新稳定版本，旧版本可能对系统schema的过滤逻辑更严格，新版本可能有更灵活的配置选项。

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