commons-text 1.11.0与commons-lang3版本兼容异常原因咨询

1. commons-text 1.11.0 + commons-lang3 3.14.0 出现 NoClassDefFoundError 的原因 #

该错误并非org.apache.commons.text.StringEscapeUtils类找不到，而是类初始化失败。StringEscapeUtils的静态初始化逻辑（如静态代码块、静态成员变量）依赖commons-lang3 3.13.0的特定API实现，但commons-lang3 3.14.0对相关API做了不兼容变更，导致初始化过程中抛出未捕获的异常，最终表现为Could not initialize class错误。

2. commons-text 1.11.0 + commons-lang3 3.13.0 出现 NoSuchMethodError 的原因 #

这个错误的核心是运行时类路径存在依赖冲突：

• 虽然Maven依赖声明显示commons-text 1.11.0依赖commons-lang3 3.13.0，但如果项目中其他依赖引入了更低版本的commons-lang3（如3.12.0及以下），Maven的依赖调解机制可能会选择更低版本。
• org.apache.commons.lang3.Range.of(java.lang.Comparable, java.lang.Comparable)方法是在commons-lang3 3.13.0中新增的，低版本中不存在该方法签名，因此调用时抛出NoSuchMethodError。

3. commons-text 1.10.0 + commons-lang3 3.12.0 正常运行的原因 #

commons-text 1.10.0的官方依赖声明就是commons-lang3 3.12.0，两个版本的API完全兼容，不存在跨版本的依赖冲突或不兼容变更，因此可以稳定运行。

解决方案 #

• 若要使用commons-text 1.11.0：
  • 执行mvn dependency:tree命令排查项目依赖树，找到引入低版本commons-lang3的依赖，通过<exclusions>标签排除该依赖的commons-lang3引用，确保运行时使用3.13.0版本。
  • 或升级commons-text至1.12.0及以上版本，这些版本已适配commons-lang3 3.14.0及后续版本。
• 若无需升级，继续使用commons-text 1.10.0 + commons-lang3 3.12.0是经过验证的稳定组合。

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