在Java Web项目开发中，web.xml是Web应用的部署描述文件，Servlet作为处理请求的核心组件，需要在该文件中进行正确配置才能被Servlet容器识别和加载。配置的核心目的是建立Servlet类与访问路径的映射关系，同时可以设置初始化参数等扩展信息。
web.xml中Servlet配置的核心标签
配置Servlet主要使用两个核心标签组，分别是<servlet>和<servlet-mapping>，二者通过<servlet-name>标签关联。
1. <servlet>标签
该标签用于定义Servlet的基本信息，内部包含的子标签如下：
- <servlet-name>：给当前Servlet起一个唯一的名称，用于后续映射关联，名称可以自定义但不能重复。
- <servlet-class>：指定Servlet类的全限定名，也就是包名加类名，容器会根据这个路径加载对应的类。
- <init-param>：可选标签，用于设置Servlet的初始化参数，可配置多个，每个参数包含<param-name>和<param-value>两个子标签。
- <load-on-startup>：可选标签，设置Servlet的加载时机，值为正整数时表示容器启动时就加载该Servlet，数字越小优先级越高。
2. <servlet-mapping>标签
该标签用于建立Servlet与访问路径的映射关系，内部子标签如下：
- <servlet-name>：需要和前面<servlet>中定义的名称完全一致，用于关联对应的Servlet。
- <url-pattern>：指定访问该Servlet的URL路径，可配置多个，支持精确匹配、路径匹配、后缀匹配等规则。
完整配置示例
假设我们有一个名为com.example.web.UserServlet的Servlet类，需要配置为访问路径/user时触发，同时设置两个初始化参数，配置代码如下：
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">
<!-- 定义Servlet -->
<servlet>
<servlet-name>userServlet</servlet-name>
<servlet-class>com.example.web.UserServlet</servlet-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<param-name>maxCount</param-name>
<param-value>100</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<!-- 配置Servlet映射 -->
<servlet-mapping>
<servlet-name>userServlet</servlet-name>
<url-pattern>/user</url-pattern>
<url-pattern>/user/*</url-pattern>
</servlet-mapping>
</web-app>
URL模式匹配规则
配置<url-pattern>时支持多种匹配规则，优先级从高到低依次为：
| 匹配类型 | 规则说明 | 示例 |
|---|---|---|
| 精确匹配 | 路径必须完全一致才能匹配 | <url-pattern>/user</url-pattern> 仅匹配 /user 请求 |
| 路径匹配 | 以/开头、以/*结尾，匹配该路径下的所有请求 | <url-pattern>/user/*</url-pattern> 匹配 /user/list、/user/detail 等请求 |
| 后缀匹配 | 以*.开头，匹配指定后缀的所有请求 | <url-pattern>*.do</url-pattern> 匹配所有以 .do 结尾的请求 |
| 默认匹配 | 写为/，匹配所有未被其他规则匹配的请求 | <url-pattern>/</url-pattern> 作为默认Servlet处理静态资源等请求 |
初始化参数获取方式
在Servlet中可以通过getInitParameter方法获取web.xml中配置的初始化参数，示例代码如下：
import javax.servlet.ServletConfig;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
public class UserServlet extends HttpServlet {
private String encoding;
private int maxCount;
@Override
public void init(ServletConfig config) throws ServletException {
super.init(config);
// 获取初始化参数
encoding = config.getInitParameter("encoding");
String maxCountStr = config.getInitParameter("maxCount");
if (maxCountStr != null) {
maxCount = Integer.parseInt(maxCountStr);
}
}
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
req.setCharacterEncoding(encoding);
// 使用maxCount参数处理业务逻辑
resp.getWriter().write("初始化参数encoding为：" + encoding + "，maxCount为：" + maxCount);
}
}
常见配置注意事项
- <servlet-name>在两个标签组中必须完全一致，否则容器无法关联Servlet和映射关系。
- <servlet-class>必须是全限定名，如果包名或者类名写错，容器启动时会报类找不到的异常。
- 同一个Servlet可以配置多个<url-pattern>，只要任意一个路径匹配就会触发该Servlet。
- 如果项目使用Servlet 3.0及以上版本，也可以使用注解方式配置Servlet，不需要在web.xml中配置，但web.xml的配置方式兼容性更好，适合需要兼容低版本容器的场景。
web.xmlServletJava_Webservlet_mapping修改时间：2026-07-22 19:06:27