Java Web开发入门：Servlet环境搭建与实战指南-平芜编程栈

1. Java Web开发入门：环境搭建与第一个Servlet程序

刚接触Java Web开发时，很多新手会被各种概念和配置搞得晕头转向。作为一个从零开始摸爬滚打多年的开发者，我想分享一套经过实战验证的入门路径。第一天我们不需要急着学习框架，而是应该先理解最基础的Servlet运行机制和环境配置。

提示：建议使用IntelliJ IDEA社区版作为开发工具，它对Java Web新手更友好，能自动处理很多基础配置

1.1 开发环境准备

首先需要安装JDK 8或11（长期支持版本），配置JAVA_HOME环境变量。验证安装是否成功：

java -version javac -version

接着安装Tomcat 9.x（平衡了稳定性和新特性）。解压后需要配置CATALINA_HOME环境变量，并测试启动：

cd $CATALINA_HOME/bin ./startup.sh # Linux/Mac startup.bat # Windows

访问http://localhost:8080应该能看到Tomcat欢迎页。常见问题包括：

端口冲突（修改conf/server.xml中的8080）
JAVA_HOME未正确设置（导致无法启动）
防火墙阻止访问（需要开放端口）

1.2 创建第一个Web项目

在IDE中新建Maven项目，选择maven-archetype-webapp模板。关键目录结构说明：

src ├── main │ ├── java # Java源代码 │ ├── resources # 配置文件 │ └── webapp # Web资源 │ ├── WEB-INF # 配置目录 │ │ └── web.xml # 部署描述符 │ └── index.jsp # 欢迎页 pom.xml # 项目配置

在pom.xml中添加Servlet API依赖：

<dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>4.0.1</version> <scope>provided</scope> </dependency>

注意：scope设为provided表示容器会提供该依赖，避免打包冲突

2. Servlet核心原理与实践

2.1 Servlet生命周期详解

创建一个简单的HelloServlet：

@WebServlet("/hello") public class HelloServlet extends HttpServlet { @Override public void init() throws ServletException { System.out.println("Servlet初始化..."); } @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { resp.setContentType("text/html"); PrintWriter out = resp.getWriter(); out.println("<h1>Hello, World!</h1>"); } @Override public void destroy() { System.out.println("Servlet销毁..."); } }

生命周期关键点：

容器加载Servlet类
调用init()初始化（仅一次）
处理请求（多次调用service()/doGet()/doPost()）
调用destroy()清理资源

2.2 请求处理流程剖析

当访问http://localhost:8080/your-app/hello时：

浏览器发送HTTP请求到Tomcat
Tomcat根据URL路径找到对应的Servlet
创建HttpServletRequest和HttpServletResponse对象
调用Servlet的service()方法
service()根据请求方法调用doGet()或doPost()
Servlet通过response对象输出响应
Tomcat将响应返回给浏览器

调试技巧：在doGet()方法开始处添加断点，可以观察完整的请求处理过程。

3. Web应用部署与调试

3.1 项目打包与部署

使用Maven打包：

mvn clean package

生成的war文件位于target目录，复制到Tomcat的webapps目录下即可自动部署。也可以配置IDE直接部署到Tomcat：

在IDEA中添加Tomcat服务器配置
指定部署的artifact（选择war exploded格式）
配置上下文路径（如/myapp）
启动调试模式

3.2 常见问题排查指南

问题现象	可能原因	解决方案
404错误	URL路径错误	检查@WebServlet注解路径
500错误	代码异常	查看Tomcat日志catalina.out
空白页	未设置contentType	resp.setContentType()
中文乱码	编码不一致	设置request/response编码

日志查看技巧：

Tomcat日志：$CATALINA_HOME/logs/catalina.out
应用日志：WEB-INF/classes下的log4j配置

4. 进阶配置与最佳实践

4.1 web.xml与注解配置对比

传统方式在web.xml中配置Servlet：

<servlet> <servlet-name>hello</servlet-name> <servlet-class>com.example.HelloServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>hello</servlet-name> <url-pattern>/hello</url-pattern> </servlet-mapping>

现代推荐使用@WebServlet注解（Servlet 3.0+），更简洁直观。两种方式可以共存，但注解优先级更高。