运行Liquibase generateChangeLog（Informix环境）遇DatabaseException求助

我之前帮不少开发者排查过这类问题，给你整理几个实用的排查方向，一步步来定位问题：

一、先核对基础配置是否正确 #

• 仔细检查liquibase配置文件里的数据库连接参数：Informix的JDBC URL格式是固定的jdbc:informix-sqli://<host>:<port>/<dbname>:INFORMIXSERVER=<servername>，别漏了INFORMIXSERVER这个关键参数，用户名和密码也确认下有没有输错。
• 确认配置里指定的changeLog生成路径是否存在，且当前执行命令的用户有写入权限——Liquibase需要把生成的内容写到文件里，路径不对或权限不够都会触发异常。

二、验证JDBC驱动兼容性 #

• 三者版本要匹配：Liquibase版本、Informix JDBC驱动版本、你的Informix数据库版本，这三者得兼容。比如Liquibase 4.x系列建议用Informix JDBC驱动4.50.x及以上的版本，老驱动可能不支持Liquibase需要的元数据查询接口，直接导致生成失败。
• 确保驱动jar包已经在Liquibase的classpath里：要么把驱动放到Liquibase安装目录的lib文件夹，要么在配置文件里用classpath参数明确指定驱动jar的路径，不然Liquibase找不到驱动也会抛数据库异常。

三、检查数据库用户权限 #

• 执行命令的数据库用户得有足够的权限读取系统元数据表：比如syscolumns、systables这些Informix的系统表，generateChangeLog本质是扫描这些表来获取库结构信息，权限不足的话根本读不到数据，自然报错。
• 可以手动用这个用户登录Informix，执行SELECT * FROM systables这类元数据查询，看看能不能正常返回结果，快速验证权限是否足够。

四、排查特殊数据库对象 #

• 检查库里有没有特殊命名的对象：比如表名/列名包含空格、特殊字符或者Informix的保留字，Liquibase在解析这些对象时容易出问题。你可以先尝试用--includeObjects参数指定一个简单的表，只生成这个表的changeLog，如果能成功，就说明是某个特殊对象导致的，再逐个排查。
• 排查是否有损坏的数据库对象：比如表结构异常、索引或触发器损坏，你可以用Informix自带的dbcheck工具检查数据库完整性，修复有问题的对象后再试。

五、开启详细日志定位根因 #

• 给命令加上--logLevel=debug参数重新执行，这样能拿到完整的异常堆栈信息，比如到底是哪个元数据查询失败，还是驱动调用时出了错，日志里会给出明确的线索。
• 重点看异常的cause部分，通常这里会直接指向问题的核心，比如驱动报错“权限不足”或者“找不到指定的系统表”，跟着这个线索就能快速解决。

内容的提问来源于stack exchange，提问作者Todd M. Roy