Java Servlet怎么配置

Java Servlet 的配置方式主要有 两种：基于 web.xml（传统方式） 和 基于注解（推荐，Servlet 3.0+）。下面分别说明，并给出完整示例。

一、基于注解配置（最常用，推荐）

要求：Servlet 3.0 及以上（Tomcat 7+）

1. 创建 Servlet 类

import jakarta.servlet.*;
import jakarta.servlet.annotation.*;
import java.io.*;

@WebServlet(
    name = "HelloServlet",
    urlPatterns = {"/hello"},
    loadOnStartup = 1
)
public class HelloServlet extends HttpServlet {
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws IOException {
        resp.setContentType("text/html;charset=utf-8");
        resp.getWriter().write("Hello Servlet!");
    }
}

2. 访问方式

http://localhost:8080/项目名/hello

✅ 不需要 web.xml

二、基于 web.xml 配置（传统方式）

1. 创建 Servlet 类

public class HelloServlet extends HttpServlet {
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws IOException {
        resp.getWriter().write("Hello Servlet!");
    }
}

2. 配置 web.xml

<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         version="5.0">

    <servlet>
        <servlet-name>HelloServlet</servlet-name>
        <servlet-class>com.example.HelloServlet</servlet-class>
    </servlet>

    <servlet-mapping>
        <servlet-name>HelloServlet</servlet-name>
        <url-pattern>/hello</url-pattern>
    </servlet-mapping>

</web-app>

三、Servlet 常见配置项

@WebServlet 常用属性

示例：

@WebServlet(
    urlPatterns = "/user",
    initParams = {
        @WebInitParam(name = "encode", value = "UTF-8")
    }
)

四、Maven 项目基本结构

src
 └── main
     ├── java
     │   └── com/example/HelloServlet.java
     ├── resources
     └── webapp
         └── WEB-INF
             └── web.xml（可选）

Maven 依赖（Tomcat 10+）

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

五、常见错误

❌ 404：urlPatterns 写错
❌ 类找不到：包名不对
❌ Tomcat 版本与 jakarta / javax 不匹配

如果你用的是 Spring Boot / Tomcat 版本 / IDEA 具体配置，可以告诉我，我可以给你更针对性的配置步骤。