必须声明war，否则maven-war-plugin不执行，webapp目录不被识别；Servlet 3.0+可省略web.xml但注解有局限；context path非根时需调整前端路径；Java/Servlet/Tomcat版本须严格对齐。
用 Maven 创建 Web 项目结构时，pom.xml 必须声明 war 打包类型
IDE（如 IntelliJ 或 Eclipse）自动生成的“Maven Webapp”模板默认是 war 类型，但如果你手动新建 Maven 项目或复制配置，容易漏掉这行：
没有它，war
maven-war-plugin 不会执行，src/main/webapp 下的 WEB-INF、静态资源、web.xml 都不会被识别和打包。Tomcat 启动时会报 java.lang.IllegalArgumentException: The main resource set specified [...] is not valid 这类路径错误。
web.xml 在 Servlet 3.0+ 中不是必需的，但 @WebServlet 注解有加载顺序限制
如果你选择不用 web.xml，直接用注解注册 Servlet，要注意：
-
@WebServlet的urlPatterns必须是静态字符串，不能拼接变量 - 多个注解 Servlet 的初始化顺序由容器决定，无法像
1 - Filter 和 Listener 同理，
@WebFilter不支持dispatcherTypes的全枚举值（如ERROR）在某些旧版 Tomcat 上会静默失效
web.xml，但涉及 Filter 链、字符编码、异常页等全局配置时，仍推荐保留一个最小化 web.xml。
Tomcat 本地调试时，context path 默认是项目名，但 IDE 插件可能覆盖它
IntelliJ 的 Tomcat 配置里有个 Application context 字段，默认填了 /；Eclipse 的 Deployment Assembly 里也对应着 / 路径映射。常见问题：
-
浏览器访问
http://localhost:8080/404，其实是项目被部署到了/myapp，应访问http://localhost:8080/myapp -
前端 AJAX 请求写死
/api/user，后端没配反向代理，结果发到根路径 404 - 静态资源路径（如
）在非根 context 下会 404，应改用./css/app.css
Java 版本与 Servlet 规范、Tomcat 版本必须对齐
错配会导致编译通过但运行时报 java.lang.NoClassDefFoundError: javax/servlet/Filter 或更隐蔽的 UnsupportedClassVersionError。关键对应关系：
- Tomcat 9 → Servlet 4.0 → 要求 Java 8+
- Tomcat 10 → Servlet 5.0 → 包名从
javax.servlet.*改为jakarta.servlet.*，老代码需替换所有 import 并更新依赖 - Maven 中
j的
avax.servlet-api
scope必须是provided，否则打包进 WAR 会和 Tomcat 自带的冲突
Server version name: Apache Tomcat/9.0.83，再对照你的 pom.xml 里的 servlet-api 版本和 java.version 输出。
实际跑通一个最简 Web 环境，核心就三件事：确认 packaging=war、验证 Tomcat 能识别 webapp 目录结构、确保 Java/Servlet/Tomcat 三者版本不打架。其余配置（日志、数据库连接池、MVC 框架）都是在此基础上叠加的，别一上来就配 Spring Boot —— 那已经不是“初始化 Web 项目环境”，而是跳过了整个底层认知过程。
