Tomcat加Maven配置的方法及常見錯(cuò)誤

更新時(shí)間：2026年02月26日 09:25:48 作者：范什么特西

文章介紹了在Maven項(xiàng)目中配置Tomcat和Java Servlet API的相關(guān)操作,本文給大家介紹的非常詳細(xì),對大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友參考下吧

Maven配置

clean：會(huì)刪除 target 目錄，清理之前的所有編譯文件
package：會(huì)重新編譯、測試、打包你的項(xiàng)目
成功后會(huì)在 target 目錄下生成：Maven_01_Test.war 文件

分析結(jié)構(gòu):

web.xml文件:

.xml：是一種標(biāo)記語言，用標(biāo)簽 <xxx> 來寫配置

<servlet>
    <servlet-name>hellow</servlet-name>           <!-- 給廚師起個(gè)小名叫"hellow" -->
    <servlet-class>com.counter.servlet</servlet-class>  <!-- 告訴服務(wù)員，hellow 廚師是張三（具體哪個(gè)類） -->
</servlet>
<servlet-mapping>
    <servlet-name>hellow</servlet-name>           <!-- 當(dāng)客人點(diǎn) hellow 套餐時(shí) -->
    <url-pattern>/hellow</url-pattern>            <!-- 客人喊"/hellow" 這個(gè)菜名 -->
</servlet-mapping>

當(dāng)用戶在瀏覽器輸入 http://localhost:8080/項(xiàng)目名/hellow
Tomcat 就會(huì)去找 com.counter.servlet 這個(gè)類
然后執(zhí)行里面的 doGet() 或 doPost() 方法

總結(jié)：web.xml 就是你的"項(xiàng)目說明書"，告訴 Tomcat 服務(wù)器你的網(wǎng)站該怎么運(yùn)行。

pom.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <!-- 1. POM版本：固定用4.0.0 -->
    <modelVersion>4.0.0</modelVersion>
    <!-- 2. 項(xiàng)目坐標(biāo)（項(xiàng)目的身份證） -->
    <groupId>com.counter</groupId>           <!-- 公司名（反寫的域名） -->
    <artifactId>Maven_01_Test</artifactId>   <!-- 項(xiàng)目名 -->
    <version>1.0-SNAPSHOT</version>          <!-- 版本號 -->
    <packaging>war</packaging>                <!-- 打包方式：war（網(wǎng)頁應(yīng)用） -->
    <!-- 3. 項(xiàng)目屬性（統(tǒng)一管理版本號） -->
    <properties>
        <maven.compiler.source>21</maven.compiler.source>   <!-- Java版本 -->
        <maven.compiler.target>21</maven.compiler.target>   <!-- Java版本 -->
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
    <!-- 4. 依賴清單（要買什么材料） -->
    <dependencies>
        <!-- Servlet API（做網(wǎng)站必備） -->
        <dependency>
            <groupId>jakarta.servlet</groupId>
            <artifactId>jakarta.servlet-api</artifactId>
            <version>6.0.0</version>
            <scope>provided</scope>  <!-- Tomcat已提供，打包時(shí)不用包含 -->
        </dependency>
        <!-- 如果需要JSP，加這個(gè) -->
        <dependency>
            <groupId>jakarta.servlet.jsp</groupId>
            <artifactId>jakarta.servlet.jsp-api</artifactId>
            <version>3.1.1</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>
    <!-- 5. 構(gòu)建配置（怎么裝修房子） -->
    <build>
        <finalName>Maven_01_Test</finalName>  <!-- 打包后的WAR文件名 -->
        <plugins>
            <!-- 編譯插件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.11.0</version>
            </plugin>
        </plugins>
    </build>
</project>

第一到第五行

<groupId>com.counter</groupId>      <!-- 你的包名：com.counter -->
<artifactId>Maven_01_Test</artifactId>  <!-- 項(xiàng)目名：Maven_01_Test -->
<version>1.0-SNAPSHOT</version>         <!-- 版本：1.0-SNAPSHOT（開發(fā)版） -->
<packaging>war</packaging>               <!-- 類型：war（網(wǎng)頁應(yīng)用） -->

2??依賴（第6-8行）

<dependencies>
    <dependency>
        <groupId>jakarta.servlet</groupId>
        <artifactId>jakarta.servlet-api</artifactId>
        <version>6.0.0</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

3??properties（第3行）

<properties>
    <maven.compiler.source>21</maven.compiler.source>  <!-- 用Java 21編譯 -->
</properties>

統(tǒng)一管理各種版本號，以后改版本只改這里

Maven 生命周期

clean   → 打掃衛(wèi)生（刪除target文件夾）
compile → 編譯代碼（把.java變成.class）
test    → 運(yùn)行測試（如果有測試代碼）
package → 打包（生成war/jar文件）
install → 裝到本地倉庫（給別的項(xiàng)目用）