適用：IntelliJ IDEA Ultimate

關(guān)鍵點(diǎn)：Web Facet + Artifact（war exploded）+ Tomcat Deployment

本文同時(shí)覆蓋兩種項(xiàng)目結(jié)構(gòu)：

1）普通 Web 目錄結(jié)構(gòu)（例如項(xiàng)目里有 web/WEB-INF）

2）Maven 標(biāo)準(zhǔn)結(jié)構(gòu)（src/main/webapp）

0. 你遇到的現(xiàn)象是什么？

當(dāng)你在 IDEA 里運(yùn)行 Tomcat（或嘗試打開(kāi)瀏覽器訪(fǎng)問(wèn)）時(shí)，彈出提示：

Browser Error

Please, configure Web Facet first!

這句話(huà)的真實(shí)含義是：IDEA 還沒(méi)把你的模塊識(shí)別為 Web 模塊，因此無(wú)法正確識(shí)別 Web 根目錄、WEB-INF、web.xml，也就沒(méi)法生成部署結(jié)構(gòu)并交給 Tomcat 跑起來(lái)。

1. 為什么會(huì)出現(xiàn)這個(gè)錯(cuò)？

常見(jiàn)原因主要有三類(lèi)：

1. 模塊沒(méi)有 Web Facet

   IDEA 不知道你的 Module 是“Web 應(yīng)用”，自然也不知道 Web 根目錄在哪里。

2. 沒(méi)有生成 Artifact（war / war exploded）

   Tomcat 運(yùn)行配置的 Deployment 需要“部署產(chǎn)物”，否則 Tomcat 不知道部署什么。

3. Web 根目錄未配置（Web Resource Directory）

   比如你的靜態(tài)資源、JSP、WEB-INF 并不在默認(rèn)路徑，需要手動(dòng)告訴 IDEA。

2. 解決方案（通用步驟，按截圖一步一步來(lái)）

步驟 1：打開(kāi) Project Structure

菜單欄：File → Project Structure…

（macOS 常用快捷鍵：? ;，Windows/Linux：Ctrl + Alt + Shift + S）

步驟 2：添加 Web Facet

左側(cè)選擇 Facets → 點(diǎn)擊左上角 “+” → 選擇 Web

這一步等于告訴 IDEA：

“這個(gè) Module 是 Web 應(yīng)用，需要 Web 根目錄、WEB-INF、web.xml 等配置。”

步驟 3：選擇要添加 Web Facet 的模塊

彈出 Choose Module 后，選擇你真正要部署到 Tomcat 的模塊（例如 Test）→ 點(diǎn)擊 OK

多模塊項(xiàng)目尤其要注意：

別選錯(cuò)模塊，否則 Artifact 會(huì)建在錯(cuò)誤模塊上，部署時(shí)會(huì)一直 404 或找不到資源。

步驟 4：配置 Web 根目錄（Web Resource Directory）與 web.xml

進(jìn)入 Web Facet 配置頁(yè)后，核心配置是：

4.1 Web Resource Directories（Web 根目錄）

把你的 Web 根目錄加入（例如 …/Test/web 或 src/main/webapp）

右側(cè) Relative path 一般保持 /（部署根路徑）。

4.2 Deployment Descriptors（可選）

如果你使用 web.xml，確認(rèn)路徑是 WEB-INF/web.xml 對(duì)應(yīng)的真實(shí)位置。

步驟 5：創(chuàng)建 Artifact（推薦 war exploded）

左側(cè)切換到 Artifacts → 點(diǎn)擊左上角 “+” → 選擇：

Web Application: Exploded → From Modules…

為什么推薦 Exploded？

• 開(kāi)發(fā)階段更友好（目錄形式）

• 修改 JSP / 靜態(tài)資源更方便驗(yàn)證

• 部署調(diào)試體驗(yàn)更好

步驟 6：選擇模塊生成 war exploded

在 Select Modules 窗口中選擇模塊（如 Test）→ 點(diǎn)擊 OK

IDEA 會(huì)生成一個(gè)類(lèi)似：Test:war exploded

步驟 7：Apply/OK 保存配置

確認(rèn)：

• Type 是 Web Application: Exploded

• Output Layout 里有 Web facet resources

最后點(diǎn)擊：Apply → OK

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

很多人做到上面不報(bào)錯(cuò)了，但 Tomcat 還是跑不起來(lái)，原因是：沒(méi)部署 Artifact。

操作如下：

1. Run → Edit Configurations… 打開(kāi)你的 Tomcat（Local）配置

2. 切到 Deployment 頁(yè)簽

3. 點(diǎn)擊 +

4. 選擇 xxx:war exploded

5. 設(shè)置 Application context（常用兩種）

   • /：根路徑（http://localhost:8080/）

   • /test：子路徑（http://localhost:8080/test）

6. Run 啟動(dòng) Tomcat

4. 針對(duì)普通 Web 目錄版和Maven 標(biāo)準(zhǔn)版這兩種項(xiàng)目結(jié)構(gòu)的“具體落地配置”

版本 A：普通 Web 目錄結(jié)構(gòu)

目錄示例

Test/
 ├─ src/（可有可無(wú)）
 ├─ web/
 │   ├─ index.jsp
 │   └─ WEB-INF/
 │       ├─ web.xml（可選）
 │       └─ lib/（可選）
 └─ ...

Web Facet 該怎么配？

在 Web Facet 頁(yè)面：

• 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 或 /（看你訪(fǎng)問(wèn)習(xí)慣）

版本 B：Maven 標(biāo)準(zhǔn) Web 項(xiàng)目（src/main/webapp）

Maven 標(biāo)準(zhǔn)目錄結(jié)構(gòu)

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

Maven 項(xiàng)目為什么也會(huì)遇到這個(gè)錯(cuò)？

有些情況下：

• 項(xiàng)目導(dǎo)入不完整

• IDEA 沒(méi)自動(dòng)識(shí)別成 Web（尤其是你把它當(dāng)普通 Java 工程導(dǎo)入時(shí)）

• module 沒(méi)帶 Web Facet

Web Facet 該怎么配？

在 Web Facet 頁(yè)面：

• 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，訪(fǎng)問(wèn)：

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

如果你用的是 Servlet 3.0+（全注解），沒(méi)有 web.xml 也沒(méi)關(guān)系，但 Web Root 必須正確是 src/main/webapp。

5. 常見(jiàn)問(wèn)題排查

1）Facets 里沒(méi)有 Web 選項(xiàng)？

• 你可能用的是 IDEA Community（社區(qū)版不帶完整 JavaEE/Tomcat 集成）

2）部署后訪(fǎng)問(wèn) 404？

• 檢查 Tomcat → Deployment 是否添加了 war exploded

• 檢查 Application context 是否正確（是不是 /test 但你訪(fǎng)問(wèn)了 /）

3）靜態(tài)資源 / JSP 訪(fǎng)問(wèn)不到？

• Web Resource Directory 配錯(cuò)了：

  普通項(xiàng)目應(yīng)該是 web/，Maven 應(yīng)該是 src/main/webapp

4）還是彈“configure Web Facet”？

• Web Facet 沒(méi)加在正確模塊上（多模塊選錯(cuò)）

• 配完沒(méi)點(diǎn) Apply/OK 保存

5）web.xml 找不到 / 報(bào) descriptor 錯(cuò)誤？

• 真實(shí)路徑不是 WEB-INF/web.xml

• 或你項(xiàng)目根本沒(méi)用 web.xml（注解方式），可不配 descriptor

結(jié)尾

配置 Web Facet 的本質(zhì)是“讓 IDEA 認(rèn)識(shí)你的模塊是 Web 應(yīng)用”，創(chuàng)建 Artifact 的本質(zhì)是“生成 Tomcat 可部署的產(chǎn)物”。只要把 Web 根目錄 和 war exploded 兩件事配對(duì)，Please, configure Web Facet first! 基本就不會(huì)再出現(xiàn)。

到此這篇關(guān)于IntelliJ IDEA運(yùn)行Tomcat報(bào)錯(cuò):Please, configure Web Facet first!解決辦法的文章就介紹到這了,更多相關(guān)IDEA運(yùn)行Tomcat報(bào)錯(cuò)Please內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論