如何配置IntelliJ使Maven项目pom.xml依赖自动添加至WEB-INF/lib目录

你遇到的是Maven WAR项目打包/部署时依赖未自动复制到WEB-INF/lib的典型问题，这会导致容器找不到依赖类。下面分几个步骤帮你解决：

一、修正pom.xml中的关键配置 #

先从项目的核心配置文件入手，调整几个关键项：

1. 规范Servlet相关依赖的scope #

Servlet API、JSP API这类依赖，容器（比如Tomcat）本身会提供，应该设置为<scope>provided</scope>，既避免打包进去浪费空间，也能避免和容器自带的类冲突。比如：

<dependency>
    <groupId>jakarta.servlet</groupId>
    <artifactId>jakarta.servlet-api</artifactId>
    <version>4.0.3</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>org.glassfish</groupId>
    <artifactId>javax.servlet</artifactId>
    <version>3.1</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>javax.servlet.jsp</groupId>
    <artifactId>jsp-api</artifactId>
    <version>2.1</version>
    <scope>provided</scope>
</dependency>

2. 完善maven-war-plugin配置 #

取消你pom里注释的maven-war-plugin，添加基础配置确保它在打包时将依赖复制到WEB-INF/lib：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.3.2</version> <!-- 使用最新稳定版 -->
            <configuration>
                <webResources>
                    <resource>
                        <directory>src/main/webapp</directory>
                        <includes>
                            <include>**/*</include>
                        </includes>
                    </resource>
                </webResources>
            </configuration>
        </plugin>
    </plugins>
</build>

二、IntelliJ IDEA中的操作 #

1. 重新导入Maven项目 #

点击右侧边栏的Maven面板，找到你的项目后点击左上角的刷新按钮（🔄），或者右键项目 -> Maven -> Reload Project，确保IntelliJ加载最新的pom配置。

2. 配置Artifact部署 #

IntelliJ默认的Artifact可能没正确包含依赖，需要手动调整：

• 打开File -> Project Structure（快捷键Ctrl+Alt+Shift+S）
• 选择Artifacts选项卡，找到你的WAR artifact
• 点击右侧的+按钮 -> Library Files，选择所有需要打包的依赖（除了标记为provided的），添加到WEB-INF/lib目录下
• 点击Apply和OK保存配置

3. 清理并重新构建 #

• 点击菜单栏Build -> Clean Project
• 然后选择Build -> Build Artifacts -> 你的WAR artifact -> Build或者Rebuild

三、手动执行Maven命令验证 #

如果上面的操作还是没解决，可以直接用Maven命令打包，验证依赖是否正常被复制：

• 打开IntelliJ的Terminal，输入：

mvn clean package

执行完成后，查看target目录下生成的WAR包，解压后检查WEB-INF/lib是否包含所有依赖JAR。如果这里是正常的，说明问题出在IntelliJ的Artifact配置，回到第二步重新调整即可。

内容的提问来源于stack exchange，提问作者Ibor Stan Onen