做网站servlet避坑指南：新手速查手册

网站做好了没人访问，这大概是很多刚入行搞后端的朋友最头疼的事。别急着怪流量不行，很多时候是因为你的网站在搜索引擎眼里就是个“黑盒”，爬虫进不去，用户也卡在半路。我见过太多安徽这边的中小企业，花大价钱请人用Servlet写了个官网，结果上线三个月，百度收录只有个位数。为啥？因为底层结构没搭好，动态页面处理得太粗糙。

今天这篇不是那种高大上的理论课，而是一份做网站servlet的实战速查手册。我是真心想帮那些想转行、或者正在安徽本地找技术活的朋友，把这块硬骨头啃下来。咱们不讲虚的，直接从需求到代码，再到上线，一步步把Servlet这个老技术在新环境下怎么“活”得明白，给你拆解清楚。

需求分析：为什么还要学Servlet？

很多人问，现在都是Spring Boot、Node.js了，还学Servlet干嘛？是不是过时了？

还真不是。你去看阿里云官方文档里关于Java Web的底层说明，会发现Servlet依然是JSP和很多传统企业系统的基石。特别是在安徽，很多传统制造业、物流企业的旧系统，底层全是JSP+Servlet。你要是想在这些公司混口饭吃，或者接点私单改改老系统，不懂Servlet连门都进不去。

而且，理解Servlet就是理解HTTP协议在Java里的落地。你搞懂了它，再去看Spring MVC，你会发现那些注解不过是包装好的Servlet而已。所以，做网站servlet的核心价值不在于“用得多”，而在于“懂原理”。对于新手来说，这是建立后端思维的最佳入门砖。

咱们先明确一下需求场景。假设你要做一个简单的企业展示站，需要展示新闻列表、员工信息，还要有个简单的后台登录。

1. 动态数据展示：页面内容要从数据库取，不能写死。
2. 交互处理：表单提交、登录验证，得能接住请求。
3. 性能要求：虽然是小站，但响应时间不能太慢，最好能复用连接。

如果你用纯HTML，以上三点全得靠JS前端模拟，数据不安全，SEO也抓不到。这时候，Servlet就派上用场了。它负责接收请求，查库，然后把数据拼成HTML返回。这就是最原始也最扎实的网站动态化方案。

环境准备：工欲善其事

别一上来就写代码，先把环境搭对，能省下一半的调试时间。我是老手了，见过太多新手卡在环境配置上，浪费好几天。

1. JDK安装 建议直接上JDK 8或者JDK 11。虽然JDK 17/21很火，但很多老项目、老服务器还是跑在8上。如果你是在安徽本地的小公司接活，JDK 8是绝对的安全牌。安装的时候，记得配置好JAVA_HOME和Path，命令行敲java -version能出来版本号，才算成功。

2. 服务器选择 Tomcat是Servlet的标配。去官网下最新的9.x或者10.x版本。解压完，改一下server.xml里的端口，默认8080容易冲突，建议改成8081或者自定义一个。启动bin/startup.sh（Linux）或startup.bat（Windows），浏览器访问http://localhost:端口能看到欢迎页，就说明服务器活了。

3. 开发工具 IDEA是首选，IntelliJ IDEA Ultimate版对Web开发支持最好。如果预算有限，Eclipse也可以，但现在用的人少了。VS Code虽然轻量，但写Servlet项目配置起来比较麻烦，不推荐新手用。

4. 数据库 MySQL 5.7或8.0。建个库，建几张表，比如news（新闻表）和user（用户表）。确保你的JDBC驱动包（如mysql-connector-java.jar）在项目的WEB-INF/lib目录下。这一步很多人忘，导致代码编译通过，一运行就报ClassNotFoundException，气得人想砸电脑。

核心步骤：从零搭建一个动态页面

好了，环境齐了，咱们开始动手。目标很简单：写一个Servlet，接收一个参数，返回一句带参数的HTML。

第一步：创建Web项目 在IDEA里，New Project -> Java Enterprise -> Web Application。选JDK版本，选Tomcat服务器。这一步系统会自动生成web.xml，虽然现在可以用注解替代，但了解这个文件很有必要，它是整个Web应用的配置文件。

第二步：编写Servlet类 新建一个类HelloServlet。注意，Servlet类必须继承HttpServlet。

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Date;/*** 简单的问候Servlet* 注意：这里使用注解来映射URL，比在web.xml里配置更简洁*/
@javax.servlet.annotation.WebServlet("/hello")
public class HelloServlet extends HttpServlet {// 处理GET请求@Overrideprotected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {// 设置响应头，告诉浏览器返回的是HTML格式，编码UTF-8// 这一步至关重要，否则中文会乱码response.setContentType("text/html;charset=UTF-8");// 获取输出流PrintWriter out = response.getWriter();// 获取请求参数，如果没有则为nullString name = request.getParameter("name");if (name == null) {name = "世界";}// 拼接HTML内容并输出// 注意：这里直接拼接字符串是演示用，实际项目严禁这样做，有XSS风险String html = "<h1>Hello, " + name + "!</h1>";html += "<p>当前时间：" + new Date() + "</p>";out.println(html);out.flush();out.close();}// 处理POST请求，通常重定向到GET@Overrideprotected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {this.doGet(request, response);}
}

第三步：部署与测试 把项目部署到Tomcat，启动服务。在浏览器地址栏输入http://localhost:8081/你的项目名/hello?name=安徽。 如果页面显示了“Hello, 安徽!”，恭喜你，你打通了做网站servlet的第一个闭环。

关键点解析：

• @WebServlet注解：相当于在web.xml里注册了这个Servlet，映射路径是/hello。
• doGet和doPost：分别处理GET和POST请求。浏览器地址栏直接访问是GET，表单提交通常是POST。
• response.setContentType：必须设置，不然浏览器不知道返回的是什么，编码也不对。
• PrintWriter：用来写响应体。用完记得close()，虽然容器会自动关闭，但养成好习惯总没错。

代码/配置示例：处理动态数据与表单

上面的例子太简单，实际做网站，肯定要从数据库取数据。咱们来一个稍微复杂点的：展示新闻列表。

假设数据库里有个news表，字段有id, title, content。

1. 数据库连接工具类 别在每个Servlet里都写连接代码，抽出来。

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;public class DBUtil {private static final String URL = "jdbc:mysql://localhost:3306/myweb?useSSL=false&serverTimezone=UTC";private static final String USER = "root";private static final String PASSWORD = "123456";static {try {Class.forName("com.mysql.cj.jdbc.Driver");} catch (ClassNotFoundException e) {e.printStackTrace();}}public static Connection getConnection() throws SQLException {return DriverManager.getConnection(URL, USER, PASSWORD);}
}

2. 新闻列表Servlet

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.Statement;
import java.sql.SQLException;@WebServlet("/news")
public class NewsListServlet extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {response.setContentType("text/html;charset=UTF-8");PrintWriter out = response.getWriter();// 简单的HTML头部out.println("<html><head><meta charset='UTF-8'><title>新闻列表</title></head><body>");out.println("<h2>最新新闻</h2><ul>");Connection conn = null;Statement stmt = null;ResultSet rs = null;try {// 获取连接conn = DBUtil.getConnection();// 创建语句stmt = conn.createStatement();// 执行查询rs = stmt.executeQuery("SELECT title, content FROM news ORDER BY id DESC LIMIT 5");// 遍历结果集，拼接HTMLwhile (rs.next()) {String title = rs.getString("title");String content = rs.getString("content");// 简单截断内容if (content.length() > 50) {content = content.substring(0, 50) + "...";}out.println("<li><b>" + title + "</b> - " + content + "</li>");}} catch (SQLException e) {// 出错时，返回友好提示，而不是堆栈信息out.println("<li style='color:red;'>数据库连接失败，请稍后重试。</li>");e.printStackTrace(); // 日志记录，方便排查} finally {// 关闭资源，顺序：rs -> stmt -> conntry { if (rs != null) rs.close(); } catch (SQLException e) { e.printStackTrace(); }try { if (stmt != null) stmt.close(); } catch (SQLException e) { e.printStackTrace(); }try { if (conn != null) conn.close(); } catch (SQLException e) { e.printStackTrace(); }}out.println("</ul></body></html>");out.flush();}
}

代码点评：

• 资源关闭：finally块里必须关闭ResultSet、Statement和Connection。这是Servlet开发中最大的坑之一，资源不释放，数据库连接池会耗尽，网站直接崩。
• 异常处理：捕获SQLException，给用户看友好提示，把详细错误打印到控制台。千万别把SQLException的堆栈直接吐给浏览器，那是安全漏洞。
• SQL注入风险：上面的代码直接拼接SQL，虽然这里只是查询，但如果是用户输入，一定要用PreparedStatement。这是底线。

常见报错与解决：新手避坑指南

做网站servlet，报错是家常便饭。这里总结几个最高频的坑，对着检查，能省你不少事。

1. 404 Not Found

• 现象：访问Servlet路径，浏览器显示404。
• 原因：
  • 路径写错了。检查@WebServlet里的路径和浏览器访问的路径是否一致。
  • 项目没部署成功。看Tomcat控制台有没有编译错误。
  • web.xml配置冲突。如果用了注解，检查web.xml里有没有重复配置。
• 解决：F12打开浏览器开发者工具，看Network标签，确认请求URL。检查Tomcat日志catalina.out，看有没有ClassNotFoundException或ServletException。

2. 500 Internal Server Error

• 现象：页面显示500错误。
• 原因：
  • 代码里抛出了未捕获的异常，比如NullPointerException。
  • 数据库连接失败。
  • 类型转换错误。
• 解决：必须看Tomcat控制台日志！ 500错误页面通常只有“An error occurred”这种废话，真正的错误原因在控制台。找到Exception那一行，根据堆栈信息定位代码。

3. 中文乱码

• 现象：页面显示??或测试。
• 原因：
  • response.setContentType("text/html;charset=UTF-8")没设置。
  • 请求参数编码不对。如果是POST表单，需要在doPost第一行加request.setCharacterEncoding("UTF-8")。
  • 源文件编码不是UTF-8。
• 解决：检查以上三点。确保IDEA里文件编码是UTF-8，Tomcat里web.xml的<request-character-encoding>也设为UTF-8。

4. ClassNotFound Exception

• 现象：启动时或运行时报ClassNotFoundException: com.mysql.cj.jdbc.Driver。
• 原因：JDBC驱动包没放在WEB-INF/lib下，或者没导入项目。
• 解决：检查WEB-INF/lib目录，确保mysql-connector-java-x.x.x.jar在里面。如果是Maven项目，检查pom.xml里的依赖是否正确下载。

5. Servlet未初始化

• 现象：init()方法没执行，或者service()方法报错。
• 原因：Servlet类没有正确继承HttpServlet，或者@WebServlet注解写错。
• 解决：检查类定义，确保继承关系正确，注解路径无误。

小结：从Servlet到职业进阶

看完这篇速查手册，你应该对做网站servlet有了完整的认知。它不仅仅是写几个类、连个数据库，更是一种对Web请求生命周期、资源管理、异常处理的理解。

对于在安徽或者国内其他城市从事IT工作的人来说，Servlet技术虽然“老”，但它的底层逻辑是“新”的。很多高级框架，本质上都是对Servlet API的封装和优化。你懂了Servlet，再看Spring Boot，会觉得豁然开朗。

关于职业发展，我有几点实在的建议：

1. 别只盯着Servlet：学完Servlet，立刻去学JSP（虽然现在用得少，但很多老项目有），然后是Servlet 3.0+的异步特性，再过渡到Spring MVC。这条路径最顺畅。
2. 证书与年审：如果你打算往架构师方向发展，可以考一下软考中级（软件设计师）或高级（系统架构设计师）。这些证书在很多国企、事业单位是有用的，而且有效期终身，但要注意定期更新知识体系，因为技术迭代快，证书代表的是你某个时间点的能力，年审更多是对你持续学习能力的检验（虽然证书本身不年审，但行业内的“隐形年审”是看你技术栈是否过时）。
3. 变更与注销：如果你从传统Java Web转向云原生、微服务，不要觉得之前的Servlet知识作废了。它们是地基。但在简历上，要如实描述你使用的技术栈，不要夸大。如果项目里用了Spring Boot，就写Spring Boot，不要写Servlet，除非你真的是裸写Servlet。诚实是技术人最大的通行证。
4. 本地化机会：安徽合肥、芜湖等地，有不少制造业企业正在数字化转型，他们需要懂Java后端、能维护旧系统、也能搭新系统的人。Servlet基础扎实，是你进入这些公司的敲门砖。

最后，回到开头的问题：网站做好了没人访问，往往是因为技术底子没打牢，或者SEO结构没做好。Servlet是后端，但它决定了前端能展示什么。一个响应快、结构清晰、无错误日志的网站，才是SEO和用户体验的基础。

你更倾向模板建站还是定制开发？欢迎在评论区聊聊你的看法，咱们一起交流避坑经验。