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免费学习笔记（深入）”；
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 单路径用
@WebServlet("/login")最简洁（等价于value = "/login"） - 多路径必须用
urlPatterns = {"/v1/user", "/v2/user"} -
name属性不填会自动生成，但如果你在web.xml里用<servlet-name></servlet-name>引用它，就必须显式指定name
web.xml 和 @WebServlet 同时存在时谁生效
都生效，但有覆盖规则：同一个 Servlet 类，如果 web.xml 声明了 <servlet></servlet>，又用 @WebServlet 标记了同个类，Tomcat 8+ 默认以 web.xml 为准，注解被忽略——连 initParams 都不会合并。
性能影响：注解扫描本身有开销，哪怕被忽略，容器启动时仍要扫描所有 class 文件；而 web.xml 是直接解析 XML，更快更确定。
- 想强制启用注解？在
web.xml顶部加<metadata-complete></metadata-complete>（默认是true） - Spring Boot 项目默认禁用
web.xml，所以@WebServlet自然生效；但传统 WAR 包部署时，这个开关常被忽略 - 混合配置最危险的点：开发时只改注解，测试环境却因
metadata-complete="true"完全不生效，问题延迟暴露
Servlet 3.0+ 环境下还值得写 web.xml 吗
值得，但只在特定地方：统一的过滤器链顺序、<error-page></error-page>、<session-config></session-config>、JSP 相关配置（如 <jsp-config></jsp-config>），这些目前没有对应注解。
容易踩的坑是以为“全注解=彻底告别 XML”，结果发现 404 页面跳转失效、session 超时设不生效，或者 JSP 里的 EL 表达式被当成纯文本输出——全是 web.xml 缺失导致。
-
<filter-mapping></filter-mapping>的顺序无法用注解控制，必须靠web.xml显式排列 -
@WebFilter只能指定 URL 模式或 Servlet 名，无法绑定到某个<filter></filter>的具体实例 - 如果你用的是 Undertow 或 Jetty，它们对注解的支持细节和 Tomcat 有差异，XML 反而更稳
真正复杂的不是选 XML 还是注解，而是搞清哪些配置只能靠哪边落地——漏掉一个 <error-page></error-page>，线上 500 错误就裸奔返回堆栈。
