IMAPFolder.getSortedMessages方法在Liferay/Tomcat环境下无法调用但普通Java应用中正常运行的问题排查

你碰到的这个NoSuchMethodError其实是很典型的类加载冲突问题，我帮你拆解下原因和解决办法：

问题根源 #

普通Java应用里你能正常调用getSortedMessages，但放到Liferay/Tomcat里就报错，核心原因是：
Tomcat或者Liferay容器本身已经自带了旧版本的Java Mail（javax.mail）或Activation框架库，而你项目pom.xml里引入的是带getSortedMessages方法的新版本。容器的类加载机制会优先加载自身的旧库，导致运行时用的是没有这个方法的旧版IMAPFolder类——这也是为什么其他基础方法（比如getMessages）能正常工作，只是新增的排序方法找不到。

解决方案 #

1. 先排查容器自带的旧库 #

先去容器的lib目录找找有没有旧版本的mail.jar、javax.mail.jar或者activation.jar：

• Tomcat的路径一般是${TOMCAT_HOME}/lib
• Liferay的话可能在${LIFERAY_HOME}/tomcat/lib或者${LIFERAY_HOME}/osgi/modules下

找到后可以先临时移走（记得备份！），重启服务测试，如果问题解决了，就说明确实是旧库冲突。

2. 强制Maven使用指定版本的Java Mail #

如果不能移除容器的旧库，就从项目依赖入手：
首先在pom.xml里明确指定最新稳定版的Java Mail和Activation依赖，确保版本统一：

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version> <!-- 也可以用更新的稳定版，比如1.6.5 -->
    <scope>compile</scope>
</dependency>
<dependency>
    <groupId>com.sun.activation</groupId>
    <artifactId>javax.activation</artifactId>
    <version>1.2.0</version>
    <scope>compile</scope>
</dependency>

然后用mvn dependency:tree命令查看项目的依赖树，看看有没有其他依赖（比如Liferay相关的包）间接引入了旧版本的javax.mail/activation，如果有，就把它们排除掉：

<!-- 示例：排除Liferay依赖中的旧版Java Mail -->
<dependency>
    <groupId>com.liferay.portal</groupId>
    <artifactId>liferay-portal</artifactId>
    <version>你的Liferay版本</version>
    <exclusions>
        <exclusion>
            <groupId>javax.mail</groupId>
            <artifactId>mail</artifactId>
        </exclusion>
        <exclusion>
            <groupId>javax.activation</groupId>
            <artifactId>activation</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. 调整Tomcat的类加载优先级 #

如果上面的方法还不行，可以修改Tomcat的类加载顺序，让项目WEB-INF/lib里的库优先加载：
在你的项目的META-INF/context.xml文件中添加以下配置：

<Context antiResourceLocking="true" privileged="true">
    <!-- 其他原有配置 -->
    <Loader delegate="false" />
</Context>

Tomcat默认的delegate是true，也就是先加载容器lib里的类，再加载项目的；改成false后会优先加载项目WEB-INF/lib中的类，这样就能用上你引入的新版本Java Mail了。

4. 验证类加载情况 #

可以在代码里加一行日志，确认当前IMAPFolder类是从哪里加载的：

LOGGER.error("IMAPFolder类加载路径: {}", IMAPFolder.class.getProtectionDomain().getCodeSource().getLocation());

如果输出的是容器lib的路径，说明还是加载了旧版本，需要继续调整依赖或配置；如果是你项目WEB-INF/lib的路径，就说明配置生效了。

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