Liquibase创建日志与锁表时的权限问题排查求助

问题场景 #

给现有项目添加Liquibase支持时，执行changelog-sync-sql可正常生成所有SQL，但执行changelog-sync时报权限不足错误：

Unexpected error running Liquibase: ORA-01031: insufficient privileges
 [Failed SQL: (1031) CREATE TABLE <schema>.DATABASECHANGELOGLOCK ...

相同JDBC连接串、用户名密码下，手动执行该建表语句完全正常，使用Liquibase 4.23.0 + Oracle数据库，开启FINE级调试后发现Liquibase重试10次仍失败。

排查步骤 #

• 显式指定schema上下文
  Liquibase可能默认使用连接的默认schema而非你指定的<schema>，在liquibase.properties或命令行中添加defaultSchemaName=<你的schema名>，确保和手动执行时的schema一致。

• 核对JDBC连接串参数
  检查Liquibase使用的JDBC串是否和手动工具（如SQLPlus、DBeaver）的完全一致，尤其注意currentSchema这类会影响会话schema的参数，避免因参数差异导致权限上下文变化。

• 检查Liquibase权限预检查逻辑
  查看FINE级日志中权限检查阶段的SQL，确认是否有额外的权限需求（比如查询数据字典视图），手动执行这些检查SQL，看是否存在权限缺失。

• 降级Liquibase版本测试
  4.23.0版本可能存在Oracle环境下的特定兼容问题，尝试降级到4.22.x或4.21.x稳定版本，重新执行changelog-sync验证是否解决问题。

• 显式启用数据库角色
  如果用户的建表权限是通过角色赋予而非直接权限，部分JDBC驱动不会自动启用角色。在liquibase.properties中添加connectionProperties=oracle.jdbc.roleName=<你的角色名>，强制启用对应角色。

• 捕获实际执行的SQL
  开启DEBUG级日志或使用Oracle审计功能，捕获Liquibase发送到数据库的完整建表语句，对比手动执行的语句是否存在差异（比如schema大小写、隐藏引号等）。

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