在Java里如何搭建Web开发环境_JavaServlet与Tomcat说明_技术教程

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


  jakarta.servlet
  jakarta.servlet-api
  5.0.0
  provided

手动部署 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 中的必须是完整类名（如 com.example.HelloServlet），包路径和 class 文件实际位置要严格一致。

@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..log 才记录 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 验证一次。