IntelliJ IDEA 运行 Tomcat 报错：Please, configure Web Facet first!
适用版本：IntelliJ IDEA Ultimate
关键点：Web Facet + Artifact (war exploded) + Tomcat Deployment
本文覆盖两种项目结构：
- 普通 Web 目录结构（例如项目里有 web/WEB-INF）
- Maven 标准结构（src/main/webapp）
0. 你遇到的现象是什么？
当你在 IDEA 里运行 Tomcat（或尝试打开浏览器访问）时，弹出提示：
Browser Error Please, configure Web Facet first!
这句话的真实含义是：IDEA 还没把你的模块识别为 Web 模块，因此无法正确识别 Web 根目录、WEB-INF、web.xml，也就没法生成部署结构并交给 Tomcat 跑起来。
1. 为什么会出现这个错？
常见原因主要有三类：
- 模块没有 Web Facet：IDEA 不知道你的 Module 是'Web 应用'，自然也不知道 Web 根目录在哪里。
- 没有生成 Artifact（war / war exploded）：Tomcat 运行配置的 Deployment 需要'部署产物'，否则 Tomcat 不知道部署什么。
- Web 根目录未配置（Web Resource Directory）：比如你的静态资源、JSP、WEB-INF 并不在默认路径，需要手动告诉 IDEA。
2. 解决方案（通用步骤，按截图一步一步来）
步骤 1：打开 Project Structure
菜单栏：File → Project Structure…
（macOS 常用快捷键：⌘ ;，Windows/Linux：Ctrl + Alt + Shift + S）
步骤 2：添加 Web Facet
左侧选择 Facets → 点击左上角 '+' → 选择 Web
这一步等于告诉 IDEA：
'这个 Module 是 Web 应用，需要 Web 根目录、WEB-INF、web.xml 等配置。'
步骤 3：选择要添加 Web Facet 的模块
弹出 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。
操作如下：
- Run → Edit Configurations… 打开你的 Tomcat（Local）配置
- 切到 Deployment 页签
- 点击 +
- 选择 xxx:war exploded
- 设置 Application context（常用两种）
- /：根路径（http://localhost:8080/）
- /test：子路径（http://localhost:8080/test）
- 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，访问：
如果你用的是 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! 基本就不会再出现。