IntelliJ IDEA 运行 Tomcat 报错：Please, configure Web Facet first!

优质文章学习记录

— 6 min read
IntelliJ IDEA 运行 Tomcat 报错：Please, configure Web Facet first!

适用：IntelliJ IDEA Ultimate
关键点：Web Facet + Artifact（war exploded）+ Tomcat Deployment
本文同时覆盖两种项目结构：
1）普通 Web 目录结构（例如项目里有 web/WEB-INF）
2）Maven 标准结构（src/main/webapp）

0. 你遇到的现象是什么？

当你在 IDEA 里运行 Tomcat（或尝试打开浏览器访问）时，弹出提示：

Browser Error
Please, configure Web Facet first!

这句话的真实含义是：IDEA 还没把你的模块识别为 Web 模块，因此无法正确识别 Web 根目录、WEB-INF、web.xml，也就没法生成部署结构并交给 Tomcat 跑起来。

1. 为什么会出现这个错？

常见原因主要有三类：

  1. 模块没有 Web FacetIDEA 不知道你的 Module 是“Web 应用”，自然也不知道 Web 根目录在哪里。
  2. 没有生成 Artifact（war / war exploded）Tomcat 运行配置的 Deployment 需要“部署产物”，否则 Tomcat 不知道部署什么。
  3. 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。

操作如下：

  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! 基本就不会再出现。

Read more

湖南首条免费高速轨迹呈现：借助 Leaflet -Trackplayer 实现 WebGIS 可视化

湖南首条免费高速轨迹呈现：借助 Leaflet -Trackplayer 实现 WebGIS 可视化

目录 前言 一、相关背景 1、湖南首条免费高速-长永高速 2、还有哪些快到30年的高速 3、leaflet-trackplayer相关知识 二、基础数据准备 1、高速起止点地理编码 2、途径重要AOI和POI信息 3、高速区间道路信息 三、leaflet-trackplayer实战 1、行驶道路生成和设置 2、途径重要AOI和POI 3、车辆车牌信息模拟跟随 4、成果展示 四、总结 前言         在交通基础设施建设与数字化技术飞速发展的时代，湖南迎来了其首条免费高速公路的建成通车，这不仅是交通领域的一大突破，更是区域经济发展与民生改善的重要里程碑。然而，如何更好地展示这条高速公路的运行轨迹，为交通管理、规划以及公众出行提供直观，成为了我们亟待解决的问题。将WebGIS 技术与 Leaflet - Trackplayer 的结合，为我们提供了一种创新且高效的解决方案。WebGIS（Web 地理信息系统）
AI生成HTML原型导入Axure全攻略！3步轻松上手，设计效率翻倍！

AI生成HTML原型导入Axure全攻略！3步轻松上手，设计效率翻倍！

咱们在cursor、flowith、DeepSeek中生成高保真原型（HTML文件）后发现有些要调整的部分，如何放在Axrue中进行编辑呢？ 核心要点就是利用figma进行导入。当然你习惯figma做设计也就不用导入了Axure了。 1、figma中加入插件：html to design 1）我们进入figma https://www.figma.com/中，安装插件：html to design。可以在这个插件库里选择哈：https://divriots.com/。 2）安装完成后，选择file,上传html文件，如下HTML原型文件就导入进来啦。我们也可以直接在figma中编辑。 2、安装Axure插件 https://www.figma.com/community/plugin/837098402230990991/axure 单击右键，选择Plugins-Axure-copy selection for rp或者 copy
OpenClaw部署实战：5分钟搭建你的专属AI数字员工（附避坑指南）

OpenClaw部署实战：5分钟搭建你的专属AI数字员工（附避坑指南）

OpenClaw，这个在2026年初引爆AI圈的开源项目，正在重新定义“个人AI助手”的边界。不同于传统的聊天机器人，OpenClaw是一款开源、本地优先的自主AI代理与自动化平台，其终极目标是构建“个人AI操作系统”。本博客将从技术原理出发，手把手教你在5分钟内完成OpenClaw的本地部署，涵盖从系统环境准备到多平台配置的完整流程，深入解析新手引导向导的每个步骤，对比不同操作系统的部署差异，探讨模型选择策略，并重点关注安全沙箱配置和性能优化技巧，同时分享真实使用案例与常见问题解决方案，无论你是学生想打造智能学习助手，还是职场人士需要24小时数字员工，亦或是技术爱好者追求最新的AI工具，本指南都将为你提供最实用的部署方案和避坑建议。 一、OpenClaw技术原理概览 OpenClaw的核心定位并非传统意义上的聊天机器人，而是一款“开源、本地优先的自主AI代理与自动化平台”。它采用了创新的“微核（Microkernel）+ 插件（Skills/Channels）+ 统一网关（Gateway）”架构模式，整个系统以Gateway为控制中心，所有消息平台和客户端都通过WebSocke
告别“选择困难症”：我是如何用 AI Ping 实现大模型自由，还能省下 50% 成本的？

告别“选择困难症”：我是如何用 AI Ping 实现大模型自由，还能省下 50% 成本的？

告别“选择困难症”：我是如何用 AI Ping 实现大模型自由，还能省下 50% 成本的？ * 写在最前面 * 场景一：从“写脚本卡壳”到“批量生成” * 场景二：开发路上的“万能插头” * 使用感受 * 一点小建议与期待 * 写在最后 🌈你好呀！我是 是Yu欸🚀 感谢你的陪伴与支持~ 欢迎添加文末好友🌌 在所有感兴趣的领域扩展知识，不定期掉落福利资讯(*^▽^*) 写在最前面 版权声明：本文为原创，遵循 CC 4.0 BY-SA 协议。转载请注明出处。 在这个大模型“百花齐放”甚至“百模大战”的时代，作为一名既要写代码开发，又要频繁输出技术内容（写博文、做视频）的开发者，我每天最大的烦恼就是： “今天这个任务，