Java 11迁移后Tomcat启动报错：javax.annotation.Resource.lookup方法缺失

核心原因分析 #

javax.annotation.Resource.lookup()方法属于Java EE的JSR-250规范，Java 11已彻底移除所有Java EE相关模块（包括javax.annotation），而Java 8中这些类是内置在JDK里的。报错本质是运行时找不到该方法的定义，大概率是依赖缺失、版本不兼容或类路径冲突导致的。

具体排查步骤 #

1. 添加兼容Java 11的javax.annotation依赖 #

在pom.xml中添加符合Java 11环境的依赖，建议使用provided范围避免和容器自带依赖冲突：

<dependency>
    <groupId>javax.annotation</groupId>
    <artifactId>javax.annotation-api</artifactId>
    <version>1.3.2</version>
    <scope>provided</scope>
</dependency>

说明：1.3.2版本是兼容Java 11的稳定版本，包含lookup()方法定义。

2. 排查间接依赖冲突 #

即使target目录中看不到jsr250-api.jar，也可能是其他依赖间接引入了无lookup()方法的旧版本JSR-250包（比如1.0版本）。执行以下Maven命令查看依赖树：

mvn dependency:tree -Dincludes=javax.annotation,javax.annotation-api

如果发现旧版本依赖，在对应的依赖项中添加排除规则：

<dependency>
    <!-- 你的业务依赖 -->
    <groupId>xxx</groupId>
    <artifactId>xxx</artifactId>
    <version>xxx</version>
    <exclusions>
        <exclusion>
            <groupId>javax.annotation</groupId>
            <artifactId>jsr250-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. 确认Tomcat版本兼容性 #

Java 11需要搭配Tomcat 9.0.x及以上版本，旧版本Tomcat（如8.5.x以下）对Java 11的支持不完善，易导致注解类加载异常。检查你的Tomcat版本，若过低则升级至9.0.x或10.x。

4. 调整Maven插件配置 #

• maven-compiler-plugin：确保版本在3.8.0及以上，正确指定Java 11的编译参数：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
        <source>11</source>
        <target>11</target>
        <compilerArgs>
            <arg>--add-exports</arg>
            <arg>java.base/sun.security.x509=ALL-UNNAMED</arg>
        </compilerArgs>
    </configuration>
</plugin>

• tomcat-maven-plugin（若用Maven启动Tomcat）：使用适配Java 11的版本，比如2.2及以上；或改用独立Tomcat部署，避免插件类路径冲突。

5. 验证类加载顺序 #

Tomcat的类加载机制中，容器自带类优先于应用类加载。如果Tomcat未正确提供javax.annotation实现，或应用依赖版本与容器冲突，可尝试：

• 移除pom.xml中javax.annotation依赖的provided范围，改为compile（仅在容器未提供该类时尝试）；
• 检查Tomcat的lib目录下是否存在javax.annotation相关jar包，确认版本是否包含lookup()方法。

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