IntelliJ IDEA 运行 Tomcat 报错 Please, configure Web Facet first! 解决步骤

弹出 Choose Module 后，选择你真正要部署到 Tomcat 的模块（例如 Test）→ 点击 OK

多模块项目尤其要注意： 别选错模块，否则 Artifact 会建在错误模块上，部署时会一直 404 或找不到资源。

步骤 4：配置 Web 根目录（Web Resource Directory）与 web.xml

进入 Web Facet 配置页后，核心配置是：

4.1 Web Resource Directories（Web 根目录）

把你的 Web 根目录加入（例如 …/Test/web 或 src/main/webapp） 右侧 Relative path 一般保持 /（部署根路径）。

4.2 Deployment Descriptors（可选）

如果你使用 web.xml，确认路径是 WEB-INF/web.xml 对应的真实位置。

步骤 5：创建 Artifact（推荐 war exploded）

左侧切换到 Artifacts → 点击左上角 '+' → 选择：

Web Application: Exploded → From Modules…

为什么推荐 Exploded？

• 开发阶段更友好（目录形式）
• 修改 JSP / 静态资源更方便验证
• 部署调试体验更好

步骤 6：选择模块生成 war exploded

在 Select Modules 窗口中选择模块（如 Test）→ 点击 OK

IDEA 会生成一个类似：Test:war exploded

步骤 7：Apply/OK 保存配置

确认：

• Type 是 Web Application: Exploded
• Output Layout 里有 Web facet resources

最后点击：Apply → OK

3. 最后一步：把 Artifact 部署到 Tomcat

很多人做到上面不报错了，但 Tomcat 还是跑不起来，原因是：没部署 Artifact。

操作如下：

1. Run → Edit Configurations… 打开你的 Tomcat（Local）配置
2. 切到 Deployment 页签
3. 点击 +
4. 选择 xxx:war exploded
5. 设置 Application context（常用两种）
   • /：根路径（http://localhost:8080/）
   • /test：子路径（http://localhost:8080/test）
6. Run 启动 Tomcat

4. 针对普通 Web 目录版 和 Maven 标准版这两种项目结构的'具体落地配置'

版本 A：普通 Web 目录结构

目录示例

Test/
├─ src/（可有可无）
├─ web/
│  ├─ index.jsp
│  └─ WEB-INF/
│     ├─ web.xml（可选）
│     └─ lib/（可选）
└─ ...

Web Facet 该怎么配？

在 Web Facet 页面：

• Web Resource Directory：选择 …/Test/web
• Relative path：/

如果有 web.xml：

• Deployment Descriptor：…/Test/web/WEB-INF/web.xml

Artifact 建议

• 选择：Web Application: Exploded
• From Modules… 选择你的模块（Test）

Tomcat Deployment

• 部署 Test:war exploded
• context 建议 /test 或 /（看你访问习惯）

版本 B：Maven 标准 Web 项目（src/main/webapp）

Maven 标准目录结构

your-app/
├─ src/
│  ├─ main/
│  │  ├─ java/ （Servlet/Controller 等）
│  │  ├─ resources/ （配置文件）
│  │  └─ webapp/ （Web 根目录）
│  │     ├─ index.jsp
│  │     └─ WEB-INF/
│  │        ├─ web.xml（可选）
│  │        └─ views/...
│  └─ test/...
├─ pom.xml
└─ ...

Maven 项目为什么也会遇到这个错？

有些情况下：

• 项目导入不完整
• IDEA 没自动识别成 Web（尤其是你把它当普通 Java 工程导入时）
• module 没带 Web Facet

Web Facet 该怎么配？

在 Web Facet 页面：

• Web Resource Directory：选择 src/main/webapp
• Relative path：/

如果使用 web.xml：

• src/main/webapp/WEB-INF/web.xml

Artifact 建议

仍然是：

• Web Application: Exploded → From Modules…

Tomcat Deployment

部署 xxx:war exploded，访问：

• http://localhost:8080/你的context/

如果你用的是 Servlet 3.0+（全注解），没有 web.xml 也没关系，但 Web Root 必须正确是 src/main/webapp。

5. 常见问题排查

1）Facets 里没有 Web 选项？

• 你可能用的是 IDEA Community（社区版不带完整 JavaEE/Tomcat 集成）

2）部署后访问 404？

• 检查 Tomcat → Deployment 是否添加了 war exploded
• 检查 Application context 是否正确（是不是 /test 但你访问了 /）

3）静态资源 / JSP 访问不到？

• Web Resource Directory 配错了：普通项目应该是 web/，Maven 应该是 src/main/webapp

4）还是弹'configure Web Facet'？

• Web Facet 没加在正确模块上（多模块选错）
• 配完没点 Apply/OK 保存

5）web.xml 找不到 / 报 descriptor 错误？

• 真实路径不是 WEB-INF/web.xml
• 或你项目根本没用 web.xml（注解方式），可不配 descriptor

结尾

配置 Web Facet 的本质是'让 IDEA 认识你的模块是 Web 应用'，创建 Artifact 的本质是'生成 Tomcat 可部署的产物'。只要把 Web 根目录 和 war exploded 两件事配对，Please, configure Web Facet first! 基本就不会再出现。