0

0

Java Web项目web.xml加载顺序 Listener Filter Servlet启动顺序

星降

星降

发布时间:2026-02-13 09:13:51

|

184人浏览过

|

来源于php中文网

原创

listener → filter → servlet,且同类型按web.xml声明顺序初始化;listener最早用于全局资源初始化,filter在首请求前预处理,servlet默认懒加载或按load-on-startup值在filter后初始化。

java web项目web.xml加载顺序 listener filter servlet启动顺序

web.xml 里 Listener、Filter、Servlet 的加载顺序是固定的

Java Web 容器(如 Tomcat)启动时,web.xml 中三类组件的初始化顺序严格按 ListenerFilterServlet 执行,且同类型组件按它们在 web.xml 中的**声明顺序**依次触发。这个顺序不是可配置的,也不受类加载路径或包名影响。

常见错误现象:ServletContextListener.contextInitialized() 里尝试获取某个 Filter 初始化后才设置的上下文属性,结果为 null;或者在 Servlet.init() 中依赖某个 Filter 预加载的缓存,但缓存还没建好。

  • Listener 在容器启动最早阶段运行,适合做全局资源初始化(数据库连接池、Spring Context 加载)
  • Filter 在第一个请求到达前完成初始化,但晚于 Listener,适合做请求预处理(编码设置、权限校验)
  • Servlet 默认是懒加载(首次请求才 init),除非显式配置 <load-on-startup>1</load-on-startup>,此时它会在所有 Filter 初始化完成后立即执行 init()

load-on-startup 值只影响 Servlet 加载时机,不改变类型间顺序

load-on-startupServlet 的专属配置项,值越小越早加载,但再小也**不可能早于 Filter 初始化完成**。设成 -1 或不写,就彻底懒加载;设成 0 或正整数,只是让它在 Filter 全部 init 后、首个请求前被调用。

容易踩的坑:有人以为把 load-on-startup 设成负数能让 Servlet 比 Filter 还早,实际会被容器忽略,等同于未配置;还有人给多个 Servlet 设相同数值,期望它们并行 init,但容器仍按 web.xml 声明顺序串行调用。

立即学习Java免费学习笔记(深入)”;

Wordware
Wordware

Wordware是一个自然语言编程工具,使任何人都可以开发、迭代和部署有用的AI应用程序。

下载
  • 值为 0:比正数更早,但仍在所有 Filter 之后
  • 值为 12:都早于懒加载 Servlet,但 1 一定先于 2 初始化
  • 没写或 -1:首次 HTTP 请求触发 init(),此时 Filter 已全部 ready

Listener 和 Filter 的 init 方法里不能依赖 Servlet 的实例

因为 Servlet 实例根本还不存在。哪怕你写了 <load-on-startup>0</load-on-startup>,它的 init() 也发生在所有 Filter.init() 返回之后。所以任何在 ServletContextListenerFilter.init() 中试图通过 getServletRegistration() 或反射拿 Servlet 实例的操作,都会失败或返回 null。

典型误用场景:想在 Filter 初始化时“预热”某个 Servlet 的内部状态,或者在 Listener 里注册一个监听器,回调目标是某个 Servlet 的静态方法——这没问题;但如果回调里要访问该 Servlet 的 getServletConfig() 或成员变量,就一定会空指针。

  • Listener 只能安全操作 ServletContext、系统属性、外部配置文件
  • Filter.init() 可以读取 FilterConfig.getServletContext(),但不能假设某 Servlet 已 init
  • 真需要跨组件通信,用 ServletContext.setAttribute() + 监听器模式,别硬耦合实例引用

Spring Boot 项目里 web.xml 不生效,得看 ServletWebServerFactory

如果你用的是 Spring Boot 2.x+,默认没有 web.xml,整个生命周期由 ServletWebServerFactory 控制。这时候 Listener/Filter/Servlet 的注册顺序取决于 Java Config 或注解方式:

  • @WebListener 注解类等价于 web.xml 中的 Listener,优先级最高
  • @WebFilter 注册的 Filter,在 Spring 容器刷新后、DispatcherServlet 初始化前生效
  • DispatcherServlet 本身是 Servlet,但它是 Spring MVC 的核心,其 init 时机由 Spring Boot 自动管理,不响应 load-on-startup

所以老项目迁移到 Spring Boot 时,别指望复制一份 web.xml 就能复现原顺序——必须改用 ServletRegistrationBeanFilterRegistrationBean 显式控制 order,否则默认顺序可能和预期不符。

最常被忽略的一点:web.xml 的顺序规则只对传统 WAR 包部署有效;只要用了嵌入式容器(Tomcat/Jetty 内置),一切以 Java 配置为准,XML 文件即使存在也可能被完全跳过。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
如何配置Tomcat环境变量
如何配置Tomcat环境变量

配置Tomcat环境变量需要在系统中添加CATALINA_HOME变量,并将Tomcat的安装路径添加到PATH变量中。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

115

2023.10.26

idea如何集成Tomcat
idea如何集成Tomcat

idea集成Tomcat的步骤:1、添加Tomcat服务器配置;2、配置项目部署;3、运行Tomcat服务器;4、访问项目;5、注意事项;6、关闭Tomcat服务器。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

170

2024.02.23

怎么查看Tomcat源代码
怎么查看Tomcat源代码

查看Tomcat源代码的步骤:1、下载Tomcat源代码;2、在IDEA中导入Tomcat源代码;3、查看源代码;4、理解Tomcat的工作原理;5、参与社区和贡献;6、注意事项;7、持续学习和更新;8、使用工具和插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

98

2024.02.23

常见的tomcat漏洞有哪些
常见的tomcat漏洞有哪些

常见的tomcat漏洞有:1、跨站脚本攻击;2、跨站请求伪造;3、目录遍历漏洞;4、缓冲区溢出漏洞;5、配置漏洞;6、第三方组件漏洞。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

168

2024.02.23

tomcat日志乱码怎么解决
tomcat日志乱码怎么解决

tomcat日志乱码的解决办法:1、修改tomcat的日志编码设置;2、检查ide的编码设置;3、检查操作系统的编码设置;4、使用过滤器处理日志;5、检查外部系统的编码设置;6、检查文件编码方式等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

155

2024.02.23

weblogic和tomcat有哪些区别
weblogic和tomcat有哪些区别

weblogic和tomcat的区别:1、功能;2、性能;3、规模;4、价格;5、安全性;6、配置和管理;7、社区支持;8、集成能力;9、升级和更新;10、可靠性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

200

2024.02.23

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

237

2024.02.23

tomcat启动闪退怎么解决
tomcat启动闪退怎么解决

tomcat启动闪退的解决办法:1、检查java环境;2、检查环境变量配置;3、检查端口被占用;4、检查配置文件编码;5、检查启动时需要的配置文件;6、检查相关文件是否丢失;7、检查防火墙和杀毒软件设置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

166

2024.02.23

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

1

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 3.5万人学习

C# 教程
C# 教程

共94课时 | 9.3万人学习

Java 教程
Java 教程

共578课时 | 64.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号