load-on-startup设负数不报错但不预加载,等同于未设置;值越小优先级越高;web.xml与@WebServlet共存时默认以web.xml为准,注解被忽略。

web.xml 里 load-on-startup 设成负数会怎样
它不会报错,但 Servlet 实际不会在启动时加载——这是很多人误以为“设了就一定加载”的坑。只有非负整数才触发预加载,-1 和不写该标签效果一致,都走懒加载(首次请求才初始化)。
常见错误现象:ServletContextListener 已执行,但第一个请求仍明显卡顿,怀疑是数据库连接池没初始化好,其实只是 Servlet 没预热。
-
load-on-startup = 0:优先级最低的预加载项 -
load-on-startup = 1比= 0先加载,数值越小越早(不是越大越早) - 多个 Servlet 写相同数值,容器按
web.xml中声明顺序加载
@WebServlet 注解的 urlPatterns 和 value 能混用吗
不能。如果同时写了 @WebServlet(urlPatterns = "/api", value = "/old"),编译会通过,但运行时报 java.lang.IllegalArgumentException: urlPatterns and value cannot both be specified。
使用场景:迁移老项目时想快速加注解,容易下意识复制粘贴两个属性。记住——value 是 urlPatterns 的快捷别名,二者语义完全重叠。
立即学习“Java免费学习笔记(深入)”;
- 单路径用
@WebServlet("/login")最简洁(等价于value = "/login") - 多路径必须用
urlPatterns = {"/v1/user", "/v2/user"} -
name属性不填会自动生成,但如果你在web.xml里用<servlet-name>引用它,就必须显式指定name
web.xml 和 @WebServlet 同时存在时谁生效
都生效,但有覆盖规则:同一个 Servlet 类,如果 web.xml 声明了 <servlet>,又用 @WebServlet 标记了同个类,Tomcat 8+ 默认以 web.xml 为准,注解被忽略——连 initParams 都不会合并。
性能影响:注解扫描本身有开销,哪怕被忽略,容器启动时仍要扫描所有 class 文件;而 web.xml 是直接解析 XML,更快更确定。
- 想强制启用注解?在
web.xml顶部加<metadata-complete="false">(默认是true) - Spring Boot 项目默认禁用
web.xml,所以@WebServlet自然生效;但传统 WAR 包部署时,这个开关常被忽略 - 混合配置最危险的点:开发时只改注解,测试环境却因
metadata-complete="true"完全不生效,问题延迟暴露
Servlet 3.0+ 环境下还值得写 web.xml 吗
值得,但只在特定地方:统一的过滤器链顺序、<error-page>、<session-config>、JSP 相关配置(如 <jsp-config>),这些目前没有对应注解。
容易踩的坑是以为“全注解=彻底告别 XML”,结果发现 404 页面跳转失效、session 超时设不生效,或者 JSP 里的 EL 表达式被当成纯文本输出——全是 web.xml 缺失导致。
-
<filter-mapping>的顺序无法用注解控制,必须靠web.xml显式排列 -
@WebFilter只能指定 URL 模式或 Servlet 名,无法绑定到某个<filter>的具体实例 - 如果你用的是 Undertow 或 Jetty,它们对注解的支持细节和 Tomcat 有差异,XML 反而更稳
真正复杂的不是选 XML 还是注解,而是搞清哪些配置只能靠哪边落地——漏掉一个 <error-page>,线上 500 错误就裸奔返回堆栈。










