讲师中心 微信公众号
AI工具推荐 视频效率加速

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

夜静姑娘_4974

夜静姑娘_4974

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

|

224人浏览过

|

来源于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 中三类组件的初始化顺序严格按 Listener → Filter → Servlet 执行,且同类型组件按它们在 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-startup 是 Servlet 的专属配置项,值越小越早加载,但再小也**不可能早于 Filter 初始化完成**。设成 -1 或不写,就彻底懒加载;设成 0 或正整数,只是让它在 Filter 全部 init 后、首个请求前被调用。

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

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

Java调试
Java调试

通过 JDWP 实现 Java 远程调试:连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP:Java Debug Wire Protocol,Java 调试有线协议(Java 远程调试底层通信协议) remote JVM:远程 Java 虚拟机 step through code:代码单步调试(步入 / 步过 / 步出调试) inspect variables:变量查看 / 变量检视 stac

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

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

因为 Servlet 实例根本还不存在。哪怕你写了 <load-on-startup>0</load-on-startup>,它的 init() 也发生在所有 Filter.init() 返回之后。所以任何在 ServletContextListener 或 Filter.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 就能复现原顺序——必须改用 ServletRegistrationBean、FilterRegistrationBean 显式控制 order,否则默认顺序可能和预期不符。

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

热门AI工具

更多
VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

相关专题

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

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

925

2023.10.26

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

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

324

2024.02.23

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

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

509

2024.02.23

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

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

305

2024.02.23

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

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

348

2024.02.23

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

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

349

2024.02.23

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

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

601

2024.02.23

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

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

322

2024.02.23

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn