Liquibase类路径资源加载问题分析与解决方案

问题背景

在Liquibase 4.32.0版本中，当使用Spring Boot Maven插件打包应用时，从类路径加载变更集(changeset)的功能出现了问题。这个问题主要影响那些将应用和变更集文件打包在同一个JAR文件中的项目。

技术细节分析

问题的根源在于Liquibase的资源加载机制在处理包含多个"!"符号的URI路径时存在缺陷。在Spring Boot打包的应用中，资源路径通常会形成类似"jar:file:/path/to/app.jar!/BOOT-INF/classes!/migration/current.xml"这样的嵌套路径结构。

Liquibase 4.32.0版本中的AbstractResource.handleUriSyntax(URI)方法无法正确处理这种复杂的嵌套路径结构，导致只能获取路径的部分片段，而丢失了实际的变更集文件路径信息。

影响范围

这个问题会影响以下场景：

1. 使用Spring Boot Maven插件打包的应用
2. 变更集文件存放在类路径下(通常是src/main/resources目录)
3. 升级到Liquibase 4.32.0或更高版本后

解决方案

开发团队已经确认这个问题是由PR #6867引入的，并计划在下一个版本中修复。对于当前遇到此问题的用户，可以考虑以下临时解决方案：

1. 回退到Liquibase 4.31.1版本
2. 等待下一个包含修复的版本发布
3. 考虑将变更集文件放在非嵌套的类路径位置

技术启示

这个问题提醒我们在处理类路径资源时需要考虑各种打包工具可能产生的不同路径结构。特别是对于Spring Boot这样的框架，它使用特殊的类加载机制和打包方式，资源路径处理需要更加健壮。

对于开发类似资源加载功能的开发者来说，应该：

1. 充分测试各种打包工具产生的路径结构
2. 考虑路径中可能出现的特殊字符和嵌套情况
3. 实现更健壮的URI解析逻辑

总结

Liquibase作为流行的数据库变更管理工具，其资源加载机制需要适应各种复杂的部署环境。这个问题虽然特定于Spring Boot打包场景，但也反映了资源加载在复杂类路径环境下可能遇到的挑战。开发团队已经意识到这个问题并计划修复，用户可以根据自身情况选择合适的临时解决方案。