IntelliJ中Tomcat Jersey项目导入本地Jar包遇类找不到错误

以下是你可能遗漏的关键步骤：

• 确认system依赖路径配置准确
  检查pom.xml中的system依赖，systemPath必须指向项目内/lib目录的正确位置，建议使用Maven内置变量避免硬编码错误，示例配置：

  <dependency>
      <groupId>自定义groupId</groupId>
      <artifactId>你的本地Jar名称</artifactId>
      <version>自定义版本号</version>
      <scope>system</scope>
      <systemPath>${project.basedir}/lib/你的本地Jar文件.jar</systemPath>
  </dependency>
  

  ${project.basedir}是Maven内置的项目根目录变量，能保证路径在不同环境下的一致性。

• 配置Tomcat Maven插件，强制纳入system依赖
  Maven的tomcat-maven-plugin默认不会将system范围的依赖加入运行时类路径，需要在插件配置中显式开启：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.tomcat.maven</groupId>
              <artifactId>tomcat7-maven-plugin</artifactId> <!-- 对应你的Tomcat版本选择tomcat8/9插件 -->
              <version>2.2</version>
              <configuration>
                  <addClasspath>true</addClasspath>
                  <classpathPrefix>lib/</classpathPrefix>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

  addClasspath设为true会让插件将依赖加入运行类路径，classpathPrefix指定本地Jar的相对路径。

• 自动复制本地Jar到WEB-INF/lib目录
  Tomcat运行时优先读取WEB-INF/lib下的Jar包，可通过maven-dependency-plugin实现自动复制：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-dependency-plugin</artifactId>
              <version>3.6.0</version>
              <executions>
                  <execution>
                      <id>复制system依赖</id>
                      <phase>prepare-package</phase>
                      <goals>
                          <goal>copy-dependencies</goal>
                      </goals>
                      <configuration>
                          <includeScope>system</includeScope>
                          <outputDirectory>${project.build.directory}/${project.build.finalName}/WEB-INF/lib</outputDirectory>
                      </configuration>
                  </execution>
              </executions>
          </plugin>
      </plugins>
  </build>
  

  执行mvn prepare-package后，本地Jar会被自动复制到编译后的WEB-INF/lib目录，Tomcat运行时即可找到对应类。

• 同步IntelliJ与Maven配置
  点击IntelliJ右侧Maven面板中的Reload All Maven Projects按钮，确保IDE识别最新的依赖配置，避免项目结构与Maven配置不同步。

• 检查Tomcat运行配置的类路径
  打开IntelliJ的Run/Debug Configurations，找到你的Tomcat配置，切换到Classpath标签，确认/lib目录下的Jar包已加入User Entries，若未添加，手动点击+号导入这些Jar包。

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