Servlet+JSP家政公司管理系统：源码剖析与实战运行指南

从标题就能看出来，这是一个典型的Java Web阶段练手项目：基于Servlet的家政公司管理系统，附带完整源码。这类项目在CS专业学生、培训班学员和刚入门的Java开发手里非常常见，我自己的学习经历里也做过不止一套类似的系统。它的价值不在于“家政公司”这个业务有多复杂，而在于它把Servlet、JSP、JDBC、三层架构、会话管理、权限控制这些Java Web最核心的知识点全部串了起来，是一个能真正跑起来、能演示、能手写复现的完整闭环。

这篇文章不打算只给你讲源码里有哪些文件——我见过太多人下载了源码却打不开、跑不起来、或者跑起来不知道怎么改。我会按我自己的实操经验，把这套系统从设计思路、核心流程、数据库结构、运行步骤到二次开发方向全部拆开讲一遍。如果你是正在学Servlet、期末要交课程设计、或者想找个项目练手并搞清楚Web请求到底是怎么被处理的，这篇内容应该能帮你少踩不少坑。

先把这个项目是什么说清楚：它是一套管理家政服务公司日常业务的Web系统，核心功能围绕客户、家政人员、服务订单、预约排班、评价反馈这几个维度展开。管理员可以管理员工和订单，客户可以预约服务并查看状态，家政人员可以查看自己的工作安排。技术上几乎没有用到任何高级框架，就是最原始的Servlet手写路由和JSP渲染页面，配合JDBC操作MySQL数据库。

1. 为什么是Servlet，为什么选家政管理这个场景

1.1 Servlet没被Spring Boot“淘汰”，它只是退到了底层

很多新手上来就直接学Spring Boot，反而容易忽略一个问题：Spring Boot本身的Web能力就是建立在Servlet规范之上的。你在Spring Boot里写的Controller，底层依然会被映射到Servlet容器去处理HTTP请求。不明白这一层，遇到过滤器失效、拦截器不生效、请求编码乱码这类问题会完全没有排查方向。所以学习阶段用纯Servlet写一个完整项目，是在给后面理解框架打地基。

这套家政管理系统恰好就是这种“自讨苦吃”的学习路线：每个业务模块都要手写Servlet类、手写doGet/doPost方法、手动从request里取值、手动在response里跳转页面、手动管理session。这条路走完，你对一次HTTP请求从浏览器到服务器再到数据库最后返回浏览器的整个过程，会有非常直观的认知。

1.2 家政业务场景不简单，但复杂度刚好适合练手

家政公司的业务核心其实是三张主线的交叉：客户要下单预约服务，公司要派单给合适的家政人员，家政人员要执行服务并与客户产生评价反馈。这中间还带有服务类型划分、订单状态流转、员工排班安排等细节。它不像“学生管理系统”只有单一角色和简单的增删改查，也不像电商系统那样涉及库存、支付回调、购物车等多方联动，家政管理的复杂度正好卡在适合初学者完整走一遍的位置。

我在实际开发这类系统时感受到，它最锻炼人的不是CRUD本身，而是订单与家政人员、客户之间的关联查询。比如“查看某位客户的历次服务订单”“查看某位家政人员本月的服务安排”这类场景，需要你理清哪张表当主表、哪里该做外键关联、哪里需要JOIN查询。这些思维一旦建立，后面学MyBatis的关联映射都会轻松很多。

2. 整体设计思路与核心技术拆解

2.1 三层架构与传统MVC的组织方式

下载源码后第一件事，不要急着看代码，先看懂它的包结构。这套系统的包结构通常是这样的：

• servlet包：存放所有控制器类，负责接收请求、解析参数、调用业务层、跳转页面。这是MVC里的Controller层。
• service包：存放业务逻辑处理，比如“下单时检查该时间段是否冲突”这类规则就应该写在这里，而不是写在Servlet里。
• dao包：存放数据库访问对象，所有SQL操作封装在这里，对上层屏蔽数据库细节。
• entity或model包：存放实体类，对应数据库里的表结构，例如Customer、Worker、Order、Comment。
• util包：存放数据库连接工具类、字符串处理工具类等公共组件。
• filter包：存放过滤器，通常用来统一处理编码和登录状态的校验。
• web或WebContent目录：存放JSP页面、CSS、JS、图片等静态资源。

这种分层不是随便分的。它的核心思想是：Servlet不能直接写SQL，JSP里不能写Java业务代码，数据访问逻辑要能被多个Servlet复用。你按这个标准去读源码，会发现哪怕作者写得不够优雅，分层的意图也一定是存在的。这也是以后写代码养成好习惯的重要一步，很多人在培训班里天天听到三层架构，但真正动手审视一套完整源码的机会并不多。

2.2 系统角色与核心业务流程

家政公司管理系统一般会有两类入口，一类是后台管理员登录，另一类是前端服务大厅。管理员账号登录后进入管理后台，可以维护服务项目、管理家政人员信息、审核订单、查看评价；而服务大厅则面向普通客户，展示家政服务项目，让客户选择服务、预约上门时间、填写联系方式即可下单。

我梳理了一套典型流程：管理员先录入家政人员和服务项目，客户浏览项目后提交预约订单，管理员在待派单列表中看到新订单并手动指派家政人员，家政人员收到订单安排后上门服务，服务完成后客户可以对本次服务进行评价。整个过程看起来简单，但体现在数据层面涉及四张以上表的联动：客户表新增客户、订单表新增订单、订单状态更新、评价表新增记录。每一步都有明确的“上一次操作产生的数据如何被下一次操作使用”的逻辑路径，这也是这类项目面试时最容易被追问的地方。

2.3 数据库设计的关键考量

源码里的SQL脚本是阅读整个项目的最佳入口。家政管理系统数据库通常包含这些核心表：

设计里很重要的一点是：订单表不直接存客户姓名和家政人员姓名，而是存对应的ID。这样做的好处是，一旦客户或员工改了手机号，历史订单可以自动关联到最新信息，不用逐条更新订单表。你在源码里会看到大量rs.getInt("customer_id")再通过ID查客户表的写法，原因就是设计上做了表间关联。

数据库连接部分，源码里通常会有一个DBUtil工具类，使用DriverManager.getConnection获得连接。学习阶段这样做没有问题，但我要提醒你：这只是在演示用法。实际生产环境绝不会每次请求都新建Connection，那样数据库会承受不住。如果你接到的项目源码里数据库连接方式是裸的JDBC，那就把注意力放在“它怎么用JDBC完成一次查询”上，不要把这种写法当成最佳实践。

3. 使用web.xml方式编写Servlet的完整示意

3.1 注解方式和web.xml方式的取舍

这套系统的标题里有个关键词值得注意：使用web.xml方式编写Servlet的完整示例。在Servlet 3.0之前，每个Servlet都要在web.xml中通过<servlet>和<servlet-mapping>两个标签来完成注册和URL映射，这是一个很繁琐的过程。Servlet 3.0之后加入了@WebServlet注解，大大简化了配置。但老项目、老教材、部分企业内部老系统里仍然大量使用web.xml方式，所以通过这套源码把两种方式都搞明白，对阅读真实项目很有帮助。

基于这套家政项目，代码通常是这样组织的：

第一步：编写一个Servlet类并继承HttpServlet，重写doGet和doPost方法

java复制public class OrderServlet extends HttpServlet {

    private OrderService orderService = new OrderService();

    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        String action = request.getParameter("action");
        if ("list".equals(action)) {
            listOrders(request, response);
        } else if ("detail".equals(action)) {
            showDetail(request, response);
        } else {
            response.sendRedirect("orderList.jsp");
        }
    }

    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        request.setCharacterEncoding("UTF-8");
        // 处理新增订单、更新状态等表单提交
        doGet(request, response);
    }
}

第二步：在web.xml中注册这个Servlet，并配置它对应的URL映射

xml复制<servlet>
    <servlet-name>OrderServlet</servlet-name>
    <servlet-class>com.housekeeping.servlet.OrderServlet</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>OrderServlet</servlet-name>
    <url-pattern>/orderServlet</url-pattern>
</servlet-mapping>

<servlet-name>只是给这个Servlet起一个逻辑名字，真正决定浏览器访问路径的是<url-pattern>。你在JSP里写表单的action="orderServlet?action=add"，容器就会根据这个URL匹配到对应的Servlet。

3.2 doGet和doPost到底怎么选

这套系统的代码会频繁出现doGet和doPost，理解它们的区别在排查问题时非常重要。浏览器通过地址栏直接输入网址、点击超链接访问时，发的是GET请求，数据会拼在URL后面，肉眼可见且有长度限制。表单设置method="post"提交时发的是POST请求，数据在请求体里，相对安全，可以传大段内容。

很多Servlet会把doPost方法里的逻辑直接转发给doGet执行，或者反过来。这种做法在业务不区分请求方式的场景下是省事的。我个人的建议是：查询操作明确写GET，写操作明确写POST，不要混用。因为后期如果做权限校验或者日志记录，区分请求方式会让代码更清晰，也更符合HTTP语义。

在阅读这套源码时，建议重点看几个JSP表单和对应Servlet处理逻辑是怎么对应的。通常list.jsp里的链接会带?action=edit&id=123这样的参数，Servlet拿到参数后根据action的值做分支处理。这种用一个Servlet集中处理某个模块所有操作的方式，叫“前端控制器模式”的雏形，理解了它，后面学Spring MVC里的DispatcherServlet会豁然开朗。

4. 实操运行：从源码到能访问的完整过程

4.1 环境准备清单

先说你跑这套系统需要用到的环境，一套标准的Java Web开发环境就够了：

• JDK 8或JDK 11（如果是新下载的JDK 17以上，需要注意兼容性）
• Tomcat 8.5或Tomcat 9（建议8.5，对老项目最友好）
• MySQL 5.7或8.0（如果源码里的JDBC驱动不支持MySQL 8，需要替换驱动包）
• IDEA或Eclipse（IDEA社区版就够用，无需破解旗舰版）
• Maven不是必需，多数此类源码会用传统方式把jar包放在WEB-INF/lib目录下

这里有一个常见误区：很多同学电脑上装了Tomcat 10，结果启动项目直接报错。原因是Tomcat 10把包名从javax.servlet改成了jakarta.servlet，老项目里的import语句全部失效。解决方案很简单，别用Tomcat 10跑这类基于传统Servlet规范的项目，换一个Tomcat 8.5或9就对了。不是你的代码有问题，是版本不兼容。

4.2 导入源码并配置Tomcat的步骤

我以一个典型的IDEA操作流程为例，带你走一遍。先把源码压缩包解压，得到完整的项目目录。如果能看到pom.xml，说明是Maven工程，用IDEA直接Open这个目录即可；如果看到的是.iml文件或WEB-INF/web.xml，说明是普通Web工程，需要先确认IDEA是否装好了Java Web插件和Tomcat集成插件。

将源码导入后需要指定运行环境：IDEA里选择Run菜单下的Edit Configurations，点左上角加号找到Tomcat Server，选Local。在Application server右侧点Configure选择你本机的Tomcat安装目录。切换到Deployment页签，点加号选Artifact，把项目的war包或exploded格式加进去，将Application context设为/。如果设置成别的前缀，比如/housekeeping，那么之后访问地址就要变成http://localhost:8080/housekeeping/login.jsp，很多人启动后看到404就是这个原因。

4.3 初始化数据库与调整连接配置

数据库部分是启动前必须处理的。源码里通常有一个housekeeping.sql或db.sql文件，用Navicat或命令行的方式执行它就行。执行完成后，数据库里会自动建好表并插入少量演示数据。

接下来处理数据库连接配置。在源码中找到类似于DBUtil.java的文件，修改URL、用户名和密码。我建议把下面这段配置背下来，几乎所有JDBC项目都会用到：

java复制String url = "jdbc:mysql://localhost:3306/housekeeping?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai";
String username = "root";
String password = "123456";

serverTimezone=Asia/Shanghai在MySQL 8.0以上版本几乎是必加的，否则会报时区错误。useSSL=false可以避免一堆SSL警告。

配置完成后启动Tomcat，浏览器访问首页。如果一切正常，你会看到家政公司的前台服务大厅页面，提示你登录或预约服务。用源码里提供的管理员账号密码登录后台，通常账号是admin，密码admin，或是123456，在SQL脚本里查看t_admin表的INSERT语句就能找到。

5. 核心功能模块的实现细节与二次开发思路

5.1 用户登录与管理员权限的实现

登录功能是这套系统的门面，也是最值得你反复阅读的模块。它通常包含三个部分：登录页面上的表单、LoginServlet里的校验逻辑、Filter过滤器里的访问控制。

登录表单代码示例：

jsp复制<form action="userServlet?action=login" method="post">
    <input type="text" name="username" placeholder="请输入用户名" required>
    <input type="password" name="password" placeholder="请输入密码" required>
    <button type="submit">登录</button>
</form>

LoginServlet里的核心逻辑：

java复制String username = request.getParameter("username");
String password = request.getParameter("password");
User user = userService.login(username, password);
if (user != null) {
    request.getSession().setAttribute("loginUser", user);
    response.sendRedirect("index.jsp");
} else {
    request.setAttribute("error", "用户名或密码错误");
    request.getRequestDispatcher("login.jsp").forward(request, response);
}

注意这里用了request.getSession()来保存用户信息。HTTP协议本身是“无状态”的，服务器记不住你上次访问是谁，而Session机制在服务器端分配了一个唯一ID，并把这个ID通过Cookie发送给浏览器。浏览器后续每次请求都会带着这个Cookie，服务器就能认出你是谁。不理解Session，就没法理解为什么登录后刷新页面不会跳回登录页。

很多同学学Servlet时容易在这里陷入误区：为什么登录成功要用sendRedirect，而登录失败要用forward。区别在于：sendRedirect是服务器告诉浏览器“你去访问另一个地址”，浏览器会重新发一次全新请求，地址栏会变化，是一次重定向；forward是服务器内部把请求转发给另一个资源继续处理，浏览器地址栏不变，整个过程依然是一次请求。登录成功后跳转到首页用重定向可以防止用户刷新页面时再次提交登录表单。

权限控制的过滤器是另一个关键点。Filter在Servlet执行之前或之后拦截请求，适合做全局的跨请求逻辑。这里通常会这样写：

java复制public class LoginFilter implements Filter {

    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) {
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) resp;
        HttpSession session = request.getSession();
        Object loginUser = session.getAttribute("loginUser");
        String path = request.getRequestURI();
        if (loginUser != null || path.endsWith("login.jsp") || path.contains("userServlet")) {
            chain.doFilter(request, response);
        } else {
            response.sendRedirect("login.jsp");
        }
    }
}

在web.xml里给它配置拦截路径：

xml复制<filter>
    <filter-name>LoginFilter</filter-name>
    <filter-class>com.housekeeping.filter.LoginFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>LoginFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

当你访问系统里的任何一个jsp或Servlet时，Filter会先检查Session里有没有用户信息。没有的话一律踢回登录页。这种模式的代码量不大，但它是理解Spring Security和Shiro这类框架的入口。

5.2 订单核心流程的串联

家政公司管理系统里最具业务代表性的模块是订单管理，因为它串联了客户、家政人员、服务项目三个维度。我建议你阅读源码时按照一条主线走：客户在前台页面选择服务项目并填写联系方式，这一提交动作会触发OrderServlet中的新增逻辑，完成三个动作：先往前台Customer表里查找或插入客户记录，再往Order表中插入一笔状态为“待受理”的订单记录，最后跳转到成功页面并回显本次预约的时间和服务项目。

管理员这边对应“待派单”列表，AdminOrderServlet提供状态过滤查询，只查出状态为待派单的订单，然后逐条指派家政人员。指派操作本质上就是一条UPDATE语句，把订单的worker_id字段更新为选中的家政人员ID，同时把状态改为“已派单”。家政人员登录或管理员查看统计页面时，再通过订单状态和时间范围去检索这些数据。

这些分散的条件可以写成一个DAO方法，实现时使用动态SQL拼接：

java复制public List<Order> queryOrders(String status, String keyword) {
    StringBuilder sql = new StringBuilder("select * from t_order where 1=1 ");
    List<Object> params = new ArrayList<>();
    if (status != null && !"".equals(status)) {
        sql.append(" and status = ? ");
        params.add(status);
    }
    if (keyword != null && !"".equals(keyword)) {
        sql.append(" and customer_name like ? ");
        params.add("%" + keyword + "%");
    }
    return query(sql.toString(), params);
}

拼接“where 1=1”这种写法在不少老带新项目里非常普遍，它只是为了后续条件拼接不需要判断是否已经有条件了。严格来说它不够优雅，也略微影响SQL解析性能，但在教学项目里方便理解，不必苛求。

5.3 基于源码做业务扩展的可行方向

拿到这套源码之后，不要满足于“能跑起来”。我建议给自己布置一个小任务：加一个模块，或者改一个已有模块的业务逻辑。有几个比较自然的扩展方向：

第一个方向是给数据库加一张“服务排班表”，让客户下单时能查到某位家政人员在特定日期是否可预约。这需要新增一张表，至少包含worker_id、work_date、time_slot、status几个字段，前台查询订单时先检查排班冲突再写订单，这能帮你把逻辑复杂度跨一个台阶。

第二个方向是提升系统的交互体验，给列表页加上分页功能。单纯在前台页面用EL表达式把订单全部展示出来可以满足学习要求，但真实系统数据量大了以后，不可能一次性查出来，你可以在OrderDAO中补充分页函数。

第三个方向是性能升级，把裸JDBC的DBUtil替换为Druid连接池，再进一步替换成MyBatis；把Servlet手动路由替换成Spring MVC。这个方向彻底走一遍之后，你会发现框架只不过是把你看过的底层重复劳动封装掉了，阅读框架源码的障碍也会变小很多。

6. 运行过程中最常见的几个问题与排查思路

这一节我把实际运行这类Servlet项目时用户最容易卡住的问题整理出来。很多问题本身不难，但对于没有经验的开发者来说，报错信息看不懂，就不知道怎么收场了。

项目启动后Tomcat报404，访问首页找不到资源

这种问题大多是部署路径不对。查看IDEA下方控制台，确认访问到底层应该是什么路径，再看Tomcat的Deployment页签中的Application context是不是和你的访问路径一致。如果是手动把项目放进webapps目录运行的，确认路径为webapps/项目名，访问时要带上项目名。还要确认是否启动了Artifact部署而不是把源码目录直接拷到了webapps里，后者非常容易漏掉编译后的class文件。

页面中文全部变成问号

中文乱码是经典问题，原因通常是浏览器提交给服务器的编码和服务器解析编码不一致，或者服务器返回页面时编码设置不一致。对策分三层：第一层在JSP页面顶部加上<%@ page contentType="text/html;charset=UTF-8" language="java" %>，第二层在Servlet处理POST请求前调用request.setCharacterEncoding("UTF-8")，第三层确保连接数据库URL里带characterEncoding=UTF-8。三层都做对，基本能解决90%以上的乱码问题。

数据库驱动类找不到

运行时报ClassNotFoundException: com.mysql.jdbc.Driver或com.mysql.cj.jdbc.Driver，说明MySQL驱动jar包没有放到WEB-INF/lib目录里。老驱动用com.mysql.jdbc.Driver，新版MySQL 8驱动的类名是com.mysql.cj.jdbc.Driver。如果你的数据库是MySQL 8但源码里用的是旧驱动类名，可以把源码驱动类名改掉并放入新驱动jar包，或者换一个旧版本的MySQL继续使用。通常我建议直接改成新驱动类名。

登录后进入后台，点击菜单总是跳回登录页

如果确认登录成功、Filter也放行了login请求，但点击其他功能仍然跳转登录页，首先检查跳转到后台后Session是否被重新创建。排查重点是在LoginServlet中保存Session后，后续是否正确地通过request.getSession()获取到了同一个Session，以及检查浏览器是不是禁用了Cookie。Tomcat的JSESSIONID主要依靠Cookie传递，禁用Cookie后Session会丢失。

500错误与空指针

这类问题就需要看控制台的异常堆栈了。空指针通常发生在从数据库结果集里取字段时列名写错，或者对象查询返回null后没有判空就继续调用。在源码学习阶段，建议先把错误堆栈的Caused By部分完整看完再动手改代码，不要只看第一行。

这类项目的报错信息本质上都在Java和容器日志里，别依赖“重启”解决一切问题，学会看日志比会敲代码更重要。实际排查时也推荐在关键逻辑处用System.out.println()打印一下参数和处理结果，传统项目没有Spring Boot那套详细的启动日志，通过最原始的打印方式追踪运行状态反而最有效。

7. 一次课外扩展实践：从读源码到动手增强

源码不启动起来，看得再多也只是纸上谈兵。我实践时还给自己留了一个探索任务：要在不破坏原有模块的前提下，给系统增加一个“服务评价查看”的门户功能，这样既能检验自己是不是读懂了原有表结构，又能真正体会到数据串联带来的反馈感。

在这个任务里，我先查看了数据库里现有的comment表结构，发现它记录了订单信息和评分内容，同时订单表关联客户表，但这个页面并不直接在原有订单列表里展示评价，而是在首页额外开出一个区域展示最新三条好评，提升公司形象。

实现时我新增一个HomeCommentServlet，它只负责查数据库并转发，调之前写的OrderDAO中一个方法连表查询最近评论。紧接着在首页的JSP中插入对应的动态代码块，使用JSTL标签循环遍历请求域中存放的评论列表。经过这次改动后，我对JSP中“请求域”和Servlet中“转发”的配合方式就有了直观的感受。理解这个任务后，就真正把这个系统消化吸收了，想做其他扩展也会有思路。

记得改完一个模块后就重新部署一次项目，不要等到一口气写完所有功能再测试，那样一旦出错就会在“自己写的代码”和“源码底层的代码”哪个有问题之间反复横跳，排查效率极低。Maven的clean package或IDEA的Build Rebuild Project都可以完成代码重新编译。

我个人的经验是用“改一行、测一次、记录一步”的方式学习这套源码。最初拿到源码时肯定有看不完的地方，但只要能把“登录→客户下单→管理员派单→家政执行→评价完成”这条完整链路在源码里逐行跟一遍，对Java Web开发的理解绝对会产生质变。之后再看Spring Boot开发，你会发现框架只是帮你干了很多底层脏活累活，真正核心的业务逻辑思维是一脉相承的。