Liquibase配置需确保liquibase.properties置于src/main/resources根目录；Spring Boot中需防事务冲突，include路径须用classpath前缀；生产环境rollback须禁用命令行并强制预览SQL。
liquibase.properties 文件路径和加载顺序不对
Java 应用启动时，Liquibase 默认只在 classpath 根目录找 liquibase.properties，不是当前工作目录，也不是 src/main/resources 下任意位置——它只认 classpath:/liquibase.properties 这个确切路径。很多同学把文件放错位置（比如放在 src/main/resources/config/ 里），又没显式指定，结果配置全失效。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 确保
liquibase.properties直接放在src/main/resources/下，不嵌套子目录 - 如果必须放别处，启动时加 JVM 参数：
-Dliquibase.configurationFile=classpath:config/my-liquibase.properties - 检查是否被 Spring Boot 自动配置覆盖：若用了
spring-boot-starter-liquibase，它会忽略liquibase.properties，优先读application.yml中的spring.liquibase.*配置
Spring Boot 中 dataSource 和 liquibase 的事务隔离冲突
常见错误现象：LiquibaseException: Cannot acquire change log lock 或启动卡住。本质是 Liquibase 在初始化时尝试对 databasechangeloglock 表加锁，但此时 Spring 的 DataSource 已开启全局事务管理（比如配了 @EnableTransactionManagement），导致连接被 hold 住或复用异常。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 确认
liquibase初始化阶段不参与 Spring 的事务代理：在配置类中用@Bean(initMethod = "afterPropertiesSet")替代直接 new 实例，或使用LiquibaseAutoConfiguration默认行为（更稳妥） - 避免手动创建
Liquibasebean 并传入已代理的DataSource；如需定制，用DataSourceBuilder.create().build()单独建一个非代理数据源给 Liquibase - 若用 HikariCP，检查
connection-timeout是否过短（），Liquibase 加锁失败后重试可能超时抛异常
changeLog 文件里 include 的路径解析失败
include 标签的 file 属性值是相对于 changeLog 文件自身路径的，不是 classpath 根目录。例如主文件在 classpath:db/changelog-master.yaml，里面写 include: changelog-2024.yaml，那 Liquibase 就去找 classpath:db/changelog-2024.yaml，而不是 classpath:changelog-2024.yaml。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 所有
include路径统一用 classpath 前缀：include: classpath:db/changes/xxx.xml - YAML 格式下注意缩进：
include必须顶格，不能有空格；且同一级不能混用include和changeSet - 用
mvn liquibase:status命令提前验证路径是否可读，比等应用启动报错更快定位问题
rollback 操作在生产环境误触发的风险控制
Liquibase 的 rollback 命令默认不校验执行环境，本地跑通的脚本，一不小心在 prod 上执行 mvn liquibase:rollback -Dliquibase.tag=pre-deploy，就可能把线上表结构倒退回旧版本——尤其当 rollbackSQL 生成逻辑依赖数据库实时状态时，不可逆操作风险极高。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 生产环境禁用命令行 rollback：在 Maven profile 里设
<skip>true</skip>，或通过 CI/CD 流水线限制命令白名单 - 所有
rollback操作前强制生成 SQL 预览：mvn liquibase:rollbackSQL -Dliquibase.tag=xxx，人工核对后再决定是否执行rollback - 避免用
rollbackCount，改用带明确 tag 的rollback；tag 必须由发布流程自动打（如 Jenkins 构建时注入），禁止手工指定
最麻烦的不是语法写错，而是 rollback 的语义依赖数据库当前状态——比如某次变更删了列，下次 rollback 却发现该列已被其他服务重建，Liquibase 可能静默跳过或报错中断，这种状态漂移很难回溯。
