Liquibase生成DB2 AS/400变更日志时抛出SYSCAT类型*FILE未找到异常

DevOps 小满

2026-5-25

解决Liquibase generateChangeLog在IBM i（AS/400）上的SQL0204错误

首先，咱们先拆解你遇到的核心错误信息：

Starting Liquibase at Fri, 20 Apr 2018 14:26:14 GMT (version 3.6.1 built at 2018-04-11 08:41:04)
Unexpected error running Liquibase: liquibase.exception.DatabaseException: com.ibm.as400.access.AS400JDBCSQLSyntaxErrorException: [SQL0204] REFERENCES in SYSCAT type *FILE not found.

这个问题的根源很明确：Liquibase 3.6.1版本在查询数据库系统目录时，默认尝试访问SYSCAT.REFERENCES对象，但IBM i（原AS/400）的系统目录结构和标准DB2并不一致——它的外键引用信息存储在QSYS2.SYSCSTCOL、QSYS2.SYSCONSTRAINT这类IBM专属的系统视图中，旧版Liquibase对IBM i的兼容性支持不足，才触发了这个「对象找不到」的错误。

下面是几个优先级从高到低的可行解决办法：

优先升级Liquibase版本：3.6.1是2018年的老版本，后续的Liquibase 4.x系列大幅优化了对IBM i数据库的适配，已经修复了这类系统目录查询的兼容性问题。升级到最新稳定版（比如4.20+）后再执行generateChangeLog命令，大概率能直接解决问题。
检查JDBC驱动与连接配置：确保你使用的是IBM官方的JTOpen JDBC驱动（版本要适配你的IBM i系统），并且在连接URL中明确指定目标库/架构。示例连接URL：
```
jdbc:as400://your-ibmi-host:port/your-library;currentSchema=your-schema;naming=system
```
正确的currentSchema或library参数能避免Liquibase默认查询错误的系统目录范围。
验证数据库用户权限：确认执行Liquibase的用户拥有访问QSYS2库下系统视图的权限。如果权限不足，联系IBM i管理员授予用户对QSYS2.SYSCSTCOL、QSYS2.SYSCONSTRAINT等视图的读取权限。
临时应急方案（无法升级时）：如果暂时不能升级Liquibase，你可以尝试自定义Liquibase的DB2数据库扩展，修改它查询外键引用的逻辑，替换为IBM i对应的系统视图查询。不过这个方法需要一定的Java开发能力，仅作为临时 workaround，还是推荐优先升级版本。