如何通过web.xml文件对Java Web应用进行详细配置？

本文共计1184个文字，预计阅读时间需要5分钟。

xml

什么时候必须写 web.xml

不是所有项目都需要手动写 web.xml，但以下情况绕不开：

• 使用 Servlet 2.5 或更早规范（如 WebLogic 10.3、WebSphere 7）
• 需要配置 <error-page> 映射 HTTP 状态码或异常类（注解无法覆盖 404/500 全局页面）
• 注册实现了 ServletContextListener 的监听器且不支持 @WebListener（比如某些 OSGi 容器或定制 ClassLoader）
• 配置 <security-constraint> 做基于角色的 URL 访问控制（@ServletSecurity 支持有限）
• 需要设置 <session-config> 中的 <cookie-config> 高级属性（如 httpOnly、secure、sameSite）——部分容器对注解支持不完整

web.xml 的基本结构和必填项

一个最小可用的 web.xml 必须包含根元素 <web-app>、命名空间声明和版本号。