Java Web开发环境的核心是确保Servlet能被正确加载执行并响应HTTP请求，关键环节为JDK版本匹配、Tomcat部署结构合规、web.xml或注解配置不冲突。
Java Web 开发环境的核心不是装一堆工具，而是让 Servlet 能被正确加载、执行，并响应 HTTP 请求。关键环节只有三个：JDK 版本匹配、Tomcat 部署结构合规、web.xml 或注解配置不冲突。
确认 JDK 与 Tomcat 版本兼容性
新版 Tomcat（如 10.x）默认要求 JDK 11+，且不再支持 javax.servlet.* 包；若你用的是 JDK 17 + Tomcat 10.1，Servlet 类必须导入 jakarta.servlet.*，否则编译报错 package jakarta.servlet does not exist。
- Tomcat 9.x → 支持 JDK 8–15，用
javax.servlet.* - Tomcat 10.0+ → 强制
jakarta.servlet.*，且 Servlet API 从 4.0 升级到 5.0+ - Maven 依赖需同步调整：
tomcat-servlet-api已废弃，改用jakarta.servlet-api
<dependency> <groupId>jakarta.servlet</groupId> <artifactId>jakarta.servlet-api</artifactId> <version>5.0.0</version> <scope>provided</scope> </dependency>
手动部署 Servlet 到 Tomcat 的目录结构不能错
直接把 class 文件扔进 webapps/ROOT/WEB-INF/classes 是常见错误——缺 web.xml 或路径不对，Tomcat 根本不会扫描它。标准结构必须包含：
-
webapps/myapp/WEB-INF/web.xml（或使用@WebServlet注解） webapps/myapp/WEB-INF/classes/com/example/HelloServlet.class-
webapps/myapp/WEB-INF/lib/（如有第三方 jar）
注意：WEB-INF 必须大写，且不能放在 classes 下面；web.xml 中的 <servlet-class> 必须是完整类名（如 com.example.HelloServlet），包路径和 class 文件实际位置要严格一致。
立即学习“Java免费学习笔记（深入）”；
@WebServlet 注解比 web.xml 更简单，但有隐含限制
用 @WebServlet("/hello") 可省去 web.xml，但只在以下情况生效：
- 项目打包为
.war并部署到 Tomcat，或直接用 IDE（如 IntelliJ）以 “Exploded” 模式运行 - Servlet 类必须被 Tomcat 的类加载器加载（即不能放在
lib外部的任意路径） - Tomcat 7+ 默认启用注解扫描；若关闭了（如在
context.xml中设scanClassPath="false"），注解会失效
典型错误：本地测试时用 java -cp ... HelloServlet 直接运行，@WebServlet 完全不触发——它依赖容器启动时的类扫描机制，不是 JVM 原生特性。
启动后 404 或 405 错误，先查日志再调代码
Tomcat 启动成功不代表 Servlet 就绪。最常忽略的是日志路径：logs/catalina.out 和 logs/localhost.<date>.log</date> 才记录 Servlet 初始化失败原因。
-
404：路径没映射上 → 检查 URL 是http://localhost:8080/myapp/hello还是/hello（上下文路径是否遗漏） -
405 Method Not Allowed：Servlet 没重写对应方法（如只写了doGet()却用 POST 请求） - 控制台无任何 “Servlet.init” 日志 → 类根本没被加载，检查
WEB-INF/classes下 class 是否存在、包路径是否拼错
复杂点在于：IDE 内嵌 Tomcat 和独立安装的 Tomcat 行为可能不一致——前者常自动处理 output directory 映射，后者完全依赖你手建的目录结构。别信“能跑就行”，部署前务必用独立 Tomcat 验证一次。
