简介面向JSP初学者与课程设计人员这份在线洗衣店管理系统源码完整覆盖管理员、会员、员工三类角色支持登录注册、洗涤价格维护、订单提交、余额充值、收益查询及洗衣记录管理等典型业务适合作为毕业设计或Java Web实训参考。压缩包共48个文件主要包含21个Java类、14个JSP页面以及8个TLD标签库描述文件辅以属性配置与说明文档整体仅56KB源码轻量清晰便于快速阅读与部署。目前已有117人学习下载适合需要对照JSPServlet标签库实现分层业务逻辑的开发者参考。资源价值在于提供一套可直接运行的完整项目骨架涵盖用户端下单与员工端记录处理的闭环流程同时包含数据库配置、标签定义和项目说明可帮助理解洗衣店场景下的权限划分与状态流转也能为扩展会员管理、订单统计等功能提供基础。1. 在线洗衣店管理系统一个 JSP 老项目为什么还值得拆JSP 在线洗衣店管理系统听起来像上个时代的产物但如果你正在做 Java Web 课程设计、毕业设计或者想快速搞懂传统 JSP Servlet MySQL 项目的完整链路这份源码包反而是最省时间的样板。它不是那种只贴了登录页的碎片代码而是把管理员、员工、会员三套角色流程完整串起来涵盖衣服洗涤记录、收益查询、余额充值、会员注销这些业务点几乎覆盖了课设里会遇到的典型 CRUD 场景。我拆过不少同类源码大多数一跑就报 500或者数据库脚本缺表这套项目结构相对清爽适合新手照着部署也适合熟手拿来改业务。源码包直接解压就能看到完整工程下面我按实际复现的顺序把每层拆开说重点讲清楚每个参数怎么配、每段代码为什么那样写。2. 源码包结构与数据表先从 JavaBean 和 SQL 脚本里看出项目骨架拿到 zip 之后别急着往 Tomcat 里丢。先解压基本能确认这是一个传统 JavaWeb 工程不是 Maven 结构所以 WEB-INF 目录、classes 目录和 lib 目录的位置就是整个项目的地基。新手最容易在第一步翻车是因为把解压后的工程直接复制到 webapps 下却发现 Tomcat 找不到类。2.1 目录结构传统工程和 Maven 工程的区别传统 JSP 工程的部署结构长这样解压后你会看到类似的层级jsp_cleaner ├── srcJava 源码目录含包名如 com.cleaner.* ├── webWebContent 目录含 JSP 页面 │ ├── admin管理员相关页面 │ ├── user会员相关页面 │ ├── employee员工相关页面 │ ├── images │ └── WEB-INF │ ├── libJDBC 驱动等 jar 包 │ └── web.xmlServlet 映射配置 └── sql或 database 目录内含建表脚本逻辑说明src 目录下是 Servlet 和 JavaBean 源码编译后要输出到 web/WEB-INF/classesweb 目录下是 JSP 页面和静态资源。你如果在 IDEA 里直接打开这个目录需要把 web 目录标记为 Web 资源目录否â则 JSP 里的/根路径会解析错位。还有一种更省事的方式是直接用 IDEA 的 New Project 向导新建一个 JavaWeb 项目再把 src 和 web 目录内容覆盖进去这样 IDE 的编译输出路径和工件配置都是现成的。参数说明注意 Tomcat 版本不同web.xml 的头部声明不同。Tomcat 8 用 Servlet 3.1 声明Tomcat 9 用 Servlet 4.0 声明如果你用的是 Tomcat 10那需要把 javax.servlet 包换成 jakarta.servlet否则启动直接报 ClassNotFound。这个项目按 javax 包写老规矩配 Tomcat 8 或 9 最稳。2.2 数据库脚本看懂表结构等于看懂业务数据库脚本是这个项目最值得先看的部分。打开 SQL 文件核心是会员表、员工表、衣服洗涤记录、价格表、充值流水这几张表表和表之间通过会员 ID 关联。看脚本时重点看字段没时间把每条 SQL 都跑一遍但字段设计能直接告诉你业务边界。-- 会员表userName 是登录名balance 是余额 CREATE TABLE member ( id INT PRIMARY KEY AUTO_INCREMENT, userName VARCHAR(30) NOT NULL, password VARCHAR(30) NOT NULL, balance DECIMAL(10,2) DEFAULT 0, status INT DEFAULT 1, -- 1 正常, 0 已注销 createTime DATETIME ); -- 洗涤价格表每件衣服按类型定价 CREATE TABLE price ( id INT PRIMARY KEY AUTO_INCREMENT, clothesType VARCHAR(20) NOT NULL, price DECIMAL(10,2) NOT NULL ); -- 洗涤记录表订单流水关联会员和员工 CREATE TABLE wash_record ( id INT PRIMARY KEY AUTO_INCREMENT, memberId INT, employeeId INT, clothesType VARCHAR(20), amount DECIMAL(10,2), status INT DEFAULT 0, -- 0 待取, 1 已完成 createTime DATETIME );逻辑说明member 表里 status 字段对应「注销会员」功能不是物理删除而是软删除这样既能保留历史洗涤记录又能在登录时做状态过滤。price 表是典型的课程设计风格把衣服类型和单价放一起比单独做字典表更直观。wash_record 表是业务核心收益查询和洗涤记录管理都靠这张表聚合。参数说明DECIMAL 不能换成 FLOAT余额和收益涉及金额浮点运算会出精度问题这是我从项目里看到的处理方式也是实际项目中必须留意的点。建表脚本里如果有外键约束导入时注意先删旧表再执行。3. 本地复现JDK、Tomcat、MySQL 的版本搭配与部署顺序源码再完整跑不起来等于零。这一章直接按我自己的复现路径把环境变量、导入步骤、启动命令全部贴出来照做就行。版本搭配是第一道坎JDK 8 Tomcat 8.5 MySQL 5.7 是这套源码最保险的组合如果你已经装了 JDK 17 或 MySQL 8后面有对应的处理办法。3.1 环境准备与数据库导入先把环境理清再动手。JDK 8 和 Tomcat 8.5 下载解压安装后关键变量有这么几个# Linux / macOS 环境变量示例Windows 在系统属性里配同样的键值对 export JAVA_HOME/usr/local/jdk1.8.0_281 export CATALINA_HOME/usr/local/apache-tomcat-8.5.100 export PATH$JAVA_HOME/bin:$CATALINA_HOME/bin:$PATH # 验证 java -version startup.sh # 启动 Tomcat默认 8080 端口逻辑说明Tomcat 的 startup.sh 依赖 CATALINA_HOME 和 JAVA_HOME 两个变量配错任何一个都会启动失败。我一般先把 Tomcat 单独启动一次看到控制台输出Server startup in ...再继续配项目这样后续报错时能快速定位是环境问题还是项目问题。参数说明8080 端口如果被占用改 conf/server.xml 里的 Connector 端口 8080 换成 8081 或 9090。修改后需要重启 Tomcat 才生效同时访问地址也要跟着变。数据库导入用命令行最直接MySQL 8 的 zip 免安装版也是一样的玩法先初始化再启动服务。导入命令mysql -u root -p jsp_cleaner.sql提示如果 SQL 脚本里有CREATE DATABASE语句导入前先确认库名与项目 jdbc.properties 里的库名一致这是我拆源码时最先核对的位置。3.2 IDEA 里配置 Tomcat 与 Artifact源码不是 Maven 工程IDEA 里跑要手动配置 Artifact。我比较推荐的方法是在 IDEA 里新建一个 JavaWeb 项目然后把源码的 src 拷贝到 src 目录把 web 目录下所有内容覆盖到 web 目录。这样 IDEA 会自动生成 Artifact。依次打开 File - Project Structure - Artifacts确认输出类型是 Web Application Exploded然后在 Run - Edit Configurations 里新增 Tomcat Server - LocalTomcat Server Settings: Application Server: 选你本地的 Tomcat 8.5 URL: http://localhost:8080/jsp_cleaner/ Server - On Update Action: Redeploy Deployment - 点击 选 Artifact - 加 /jsp_cleaner逻辑说明Deployment 里的 Application Context 必须写/jsp_cleaner这决定了访问路径。如果不写默认是/那登录后跳转的地址就和实际部署路径对不上静态资源也会全部 404。这个坑我在别的项目里踩过多次每次都是因为 IDEA 自动部署的上下文和源码里 basePath 不一致。参数说明JDK 版本在 Project Structure - Project - SDK 里选 1.8如果本机只有 JDK 17也可以在同一位置添加 1.8 的 SDK 路径。编译级别选 1.8别选更高版本否则 javax.servlet 相关 API 可能因为模块化限制出现编译错误。启动前准备数据库连接配置。在 src 目录下找到 jdbc.properties 或 DBUtil.java改掉数据库账号密码jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/jsp_cleaner?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456逻辑说明com.mysql.jdbc.Driver 对应 MySQL 5.x 的旧驱动如果数据库是 MySQL 8要改成 com.mysql.cj.jdbc.Driver并加上 serverTimezone 参数。这是老 JSP 项目移植到新 MySQL 时最常见的报错点Character encoding 那一段参数也是防乱码的关键。4. 三角色功能走读订单、余额、收益报表的代码是怎么串起来的整个系统的业务链不复杂但三套角色流程交错新手容易绕晕。我把源码里的核心 Servlet 逻辑按角色拆开讲对应着功能菜单看很快就能明白哪段代码对应哪个操作。管理员管价格和员工员工管洗涤记录会员提交订单和充值主链路就是会员下单 - 员工处理 - 管理员查收益。4.1 管理员角色拦截器、价格更新与收益聚合管理员模块的关键代码在 AdminServlet登录成功后 session 里写入 admin 对象后续通过过滤器做权限判断。看代码片段WebServlet(/admin/*) public class AdminServlet extends HttpServlet { public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String action request.getPathInfo(); if (/updatePrice.equals(action)) { String clothesType request.getParameter(clothesType); double price Double.parseDouble(request.getParameter(price)); PriceDao.update(clothesType, price); response.sendRedirect(priceList.jsp); } else if (/statistics.equals(action)) { ListOrderStat stats OrderDao.statistics(); request.setAttribute(stats, stats); request.getRequestDispatcher(statistics.jsp).forward(request, response); } } }逻辑说明这个 Servlet 用 getPathInfo 做二级路由比在 web.xml 里堆一堆 servlet-mapping 好维护。updatePrice 对应「洗涤价格管理」菜单statistics 对应「收益查询」。注意收益查询不是现场算流水而是调 OrderDao.statistics() 做聚合性能上更合理也符合课设要求的简单高效。参数说明前端表单传过来的 price 是字符串必须 parseDouble但要做一次 NumberFormatException 捕获。这是老项目的通病传非法字符直接 500你可以顺手补一个 try-catch用户体验立刻不一样。4.2 会员与员工注册、余额扣减、洗涤记录状态流转会员的核心操作是提交订单和充值。订单提交的代码逻辑非常典型先查余额余额够了再扣钱、写订单否则提示余额不足public String submitOrder(long memberId, long employeeId, String clothesType, double amount) { Member member memberDao.findById(memberId); if (member.getBalance() amount) { return 余额不足请先充值; } memberDao.deductBalance(memberId, amount); WashRecord record new WashRecord(); record.setMemberId(memberId); record.setEmployeeId(employeeId); record.setClothesType(clothesType); record.setAmount(amount); record.setStatus(0); washRecordDao.insert(record); return 下单成功; }逻辑说明扣余额和插入订单没有放在事务里这是源码的简化做法也是课设项目里常见的处理。真正上线必须加 Transactional 或手动控制 connection.setAutoCommit(false)否则扣款成功但订单写入失败账就平不了。我这里展示的是源码原逻辑复现时保持原样没问题但要意识到这个边界。参数说明employeeId 在提交订单时由前端下拉列表传过来如果员工未分配或者已经被删除这里会查询不到。源码里没有做空指针保护复现时如果页面报错先检查是否漏选了员工这是最常见的人为操作失误。员工角色的「记录管理」就是列表加状态更新核心 SQL 是UPDATE wash_record SET status 1 WHERE id ?把待取的订单改成已完成。列表查询做了分页offset 和 limit 的计算在 PageBean 里用的是一页 5 条或 10 条看前端 JSP 里怎么调 Pager。4.3 前端 JSPEL 表达式与 JSTL 的分工页面层全部是 JSP但业务数据展示没怎么写 Java 脚本而是用 EL 表达式和 JSTL 标签。这对课设来说算比较规范的写法因为 scriptlet 代码多了以后JSP 编译期报错很难定位。看一个片段c:forEach items${sessionScope.member.washRecords} varrecord tr td${record.clothesType}/td td${record.amount}/td td c:if test${record.status 0}待取/c:if c:if test${record.status 1}已完成/c:if /td /tr /c:forEach逻辑说明sessionScope.member 是登录时写入 session 的完整 JavaBean里面已经通过 DAO 把 washRecords 列表装配好。这种写法在数据量小的时候很舒服但如果会员订单数量大session 里挂着一整张订单表就不合理。更好的做法是只在需要时通过订单 ID 去查页面只展示当前页数据。参数说明c:forEach 的 items 属性值来源决定数据流方向。如果是 request 作用域那说明 Servlet 在转发前把查询结果放进了 request如果是 sessionScope说明登录或刷新时已经全量加载。理解这一点调试时才能判断是 DAO 层查询问题还是 JSP 页面取值问题。5. 项目复现踩坑记录乱码、版本不兼容、JS 失效的五个实战问题这套源码我在 Windows 和 macOS 上各跑了一遍新手最容易卡死的五个问题基本固定。每条按现象、原因、解决三步写这些坑解决了项目复现基本就顺了。5.1 页面中文全是问号或者数据库中文乱码现象启动项目后页面显示的中文内容变成问号登录后会员姓名显示乱码。原因三层乱码叠加。JSP 页面没有统一编码Servlet 返回 response 时没设置 ContentType 为 UTF-8MySQL 连接串没带 characterEncodingutf8。这三个位置只要有一个不一致就会显示乱码或入库乱码。解决第一步把每个 JSP 页面头部的contentTypetext/html; charsetUTF-8pageEncoding 改为 UTF-8其他同理。第二步在 Servlet 的 doGet/doPost 入口加上request.setCharacterEncoding(UTF-8); response.setContentType(text/html;charsetUTF-8);。第三步确保 jdbc.properties 里连接串带了?useUnicodetruecharacterEncodingutf8然后重建数据库表重新导入。这三步做完乱码不会再出现。5.2 Tomcat 10 启动直接报 ClassNotFound现象启动项目时控制台报java.lang.ClassNotFoundException: javax.servlet.Filter页面全部 404。原因从 Tomcat 10 开始Servlet API 从 javax 包迁移到 jakarta 包而源码里的 import 语句全是 javax.servlet所以加载不到类。很多新手直接下载最新版 Tomcat 10图省事结果最先卡在这里。解决换成 Tomcat 8.5 或 9.0 版本重新配置 IDEA 里的 Application Server。如果必须用 Tomcat 10那就全局替换 import 为 jakarta还要替换 web.xml 头部的命名空间工作量不小不推荐为了一个课设项目这么做。版本选型本身就是避坑。5.3 访问登录页正常登录后跳转 404现象在浏览器输入http://localhost:8080/jsp_cleaner/login.jsp打开正常输入账号密码后跳转地址栏出现了http://localhost:8080/login.jsp之类的不带项目上下文的路径页面 404。原因JSP 页面里用了以/开头的绝对路径比如/login.jsp而这个/在 Tomcat 里指向的是根目录不是项目部署路径。源码里虽然大部分用了 basePath 变量但仍有个别跳转是硬编码的绝对路径。解决统一用 basePath 拼接。在每个 JSP 页面开头加如下脚本片段% String basePath request.getScheme() :// request.getServerName() : request.getServerPort() request.getContextPath() /; %然后把a href/xxx.jsp改成a href%basePath%xxx.jspredirect 同理。刷卡到这类 404先按这个规则排查一遍硬编码路径。5.4 图片和 CSS 能加载但 JS 事件全部失效现象页面样式正常但点击按钮没有响应浏览器控制台报 JS 文件 404。原因JS 文件引用路径写的是相对路径当浏览器地址栏带了长路径时相对路径解析到错误位置。比如当前 URL 是/jsp_cleaner/user/order.jsp相对路径js/common.js会解析到/jsp_cleaner/user/js/common.js而实际文件在/jsp_cleaner/js/common.js于是 404。解决页面里所有 script 和 link 标签统一改成基于 basePath 的绝对路径。例如script src%basePath%js/common.js/script这类问题在传统 JSP 多级目录结构下高发路径写法有没有混用 basePath从这个角度排查最有效。5.5 数据库连接超时或 Access denied现象Tomcat 启动没问题但访问首页或登录时页面报错控制台抛Cannot create PoolableConnectionFactory或Access denied for user rootlocalhost。原因jdbc.properties 里的账号密码和本地数据库不一致。老项目源码里默认密码往往是很短的老密码格式而 MySQL 8 默认账号密码加密方式为 caching_sha2_password旧驱动连不上或者密码本身就不对。解决第一步直接用命令行登录 MySQL确认密码正确。第二步把 jdbc.properties 里的 driver 换成com.mysql.cj.jdbc.DriverURL 加serverTimezoneAsia/Shanghai。第三步如果还报加密方式问题执行 SQL 调整 root 用户加密规则ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码; FLUSH PRIVILEGES;逻辑说明这个设置让 MySQL 8 兼容老驱动的密码校验方式改完重启项目即可连通。这不是源码的问题是新旧数据库版本之间的兼容问题遇到先按这个顺序排查比自己乱改代码高效得多。6. 拿这套源码改课程设计登录鉴权 订单状态机的最小改造源码能跑通只是第一步课设答辩时老师更关心你「改了什么」。这里给两个低成本改造点代码量不大但能明显提升项目的完成度一个是登录鉴权一个是订单状态机。登录鉴权当前是每个 Servlet 里自己查 session管理员的每个操作都要重复判断是否登录。最小改造是加一个 Filter统一拦截所有/admin/路径WebFilter(/admin/*) public class AdminAuthFilter implements Filter { public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; HttpSession session req.getSession(false); if (session null || session.getAttribute(admin) null) { ((HttpServletResponse) response).sendRedirect(req.getContextPath() /login.jsp); return; } chain.doFilter(request, response); } }逻辑说明这个 Filter 拦截所有/admin/*请求检查 session 里有没有 admin 对象。没有就强制跳回登录页有才放行。改完之后管理员相关的 Servlet 里那段重复的登录判断代码可以删掉代码变得更干净答辩时讲起来也有说头。参数说明req.getContextPath()用于拼出项目上下文路径避免部署名不同导致跳转 404。session 判断要放在 Filter 里而不是 Servlet 里这样新加的后台功能天然带鉴权不用每个方法都写检查。订单状态机是另一个值得改的点。当前源码里订单只有「待取 / 已完成」两态你可以扩展成五态已提交 - 洗涤中 - 待取 - 已完成 - 已取消。改动集中在 wash_record 表的 status 字段和 DAO 层。public static final int STATUS_SUBMITTED 0; public static final int STATUS_WASHING 1; public static final int STATUS_READY 2; public static final int STATUS_DONE 3; public static final int STATUS_CANCELED 4;逻辑说明状态用常量定义后所有判断都引用常量比裸写数字可读性强很多。再配合一个updateStatus(int id, int fromStatus, int toStatus)方法让状态只能从指定前置状态迁移到下一状态比如只有 READY 状态的订单才能改成 DONE直接改成 CANCELED 会被拒绝。这在数据库层叫乐观状态机能有效防止员工误操作把已完成订单改成已取消。参数说明如果需要前端看到状态变化时间再加一个updateTime字段每次更新状态时写入当前时间页面展示时直接用时间戳排序比用创建时间判断进度直观得多。这套改造做完你能在答辩时说清楚三件事项目本身能跑通、你理解每个角色之间的关系、你做了带约束的流程改造。源码里的套路学会了换一个别的管理系统数据库脚本和 Servlet 结构都是同一套打法。我后来自己写课设时也强制把 Filter 鉴权和状态流转先搭好再写页面从那以后项目翻车的次数明显少了希望帮到你。本文还有配套的精品资源点击获取
JSP在线洗衣店管理系统：源码部署、角色功能与课设改造指南
简介面向JSP初学者与课程设计人员这份在线洗衣店管理系统源码完整覆盖管理员、会员、员工三类角色支持登录注册、洗涤价格维护、订单提交、余额充值、收益查询及洗衣记录管理等典型业务适合作为毕业设计或Java Web实训参考。压缩包共48个文件主要包含21个Java类、14个JSP页面以及8个TLD标签库描述文件辅以属性配置与说明文档整体仅56KB源码轻量清晰便于快速阅读与部署。目前已有117人学习下载适合需要对照JSPServlet标签库实现分层业务逻辑的开发者参考。资源价值在于提供一套可直接运行的完整项目骨架涵盖用户端下单与员工端记录处理的闭环流程同时包含数据库配置、标签定义和项目说明可帮助理解洗衣店场景下的权限划分与状态流转也能为扩展会员管理、订单统计等功能提供基础。1. 在线洗衣店管理系统一个 JSP 老项目为什么还值得拆JSP 在线洗衣店管理系统听起来像上个时代的产物但如果你正在做 Java Web 课程设计、毕业设计或者想快速搞懂传统 JSP Servlet MySQL 项目的完整链路这份源码包反而是最省时间的样板。它不是那种只贴了登录页的碎片代码而是把管理员、员工、会员三套角色流程完整串起来涵盖衣服洗涤记录、收益查询、余额充值、会员注销这些业务点几乎覆盖了课设里会遇到的典型 CRUD 场景。我拆过不少同类源码大多数一跑就报 500或者数据库脚本缺表这套项目结构相对清爽适合新手照着部署也适合熟手拿来改业务。源码包直接解压就能看到完整工程下面我按实际复现的顺序把每层拆开说重点讲清楚每个参数怎么配、每段代码为什么那样写。2. 源码包结构与数据表先从 JavaBean 和 SQL 脚本里看出项目骨架拿到 zip 之后别急着往 Tomcat 里丢。先解压基本能确认这是一个传统 JavaWeb 工程不是 Maven 结构所以 WEB-INF 目录、classes 目录和 lib 目录的位置就是整个项目的地基。新手最容易在第一步翻车是因为把解压后的工程直接复制到 webapps 下却发现 Tomcat 找不到类。2.1 目录结构传统工程和 Maven 工程的区别传统 JSP 工程的部署结构长这样解压后你会看到类似的层级jsp_cleaner ├── srcJava 源码目录含包名如 com.cleaner.* ├── webWebContent 目录含 JSP 页面 │ ├── admin管理员相关页面 │ ├── user会员相关页面 │ ├── employee员工相关页面 │ ├── images │ └── WEB-INF │ ├── libJDBC 驱动等 jar 包 │ └── web.xmlServlet 映射配置 └── sql或 database 目录内含建表脚本逻辑说明src 目录下是 Servlet 和 JavaBean 源码编译后要输出到 web/WEB-INF/classesweb 目录下是 JSP 页面和静态资源。你如果在 IDEA 里直接打开这个目录需要把 web 目录标记为 Web 资源目录否â则 JSP 里的/根路径会解析错位。还有一种更省事的方式是直接用 IDEA 的 New Project 向导新建一个 JavaWeb 项目再把 src 和 web 目录内容覆盖进去这样 IDE 的编译输出路径和工件配置都是现成的。参数说明注意 Tomcat 版本不同web.xml 的头部声明不同。Tomcat 8 用 Servlet 3.1 声明Tomcat 9 用 Servlet 4.0 声明如果你用的是 Tomcat 10那需要把 javax.servlet 包换成 jakarta.servlet否则启动直接报 ClassNotFound。这个项目按 javax 包写老规矩配 Tomcat 8 或 9 最稳。2.2 数据库脚本看懂表结构等于看懂业务数据库脚本是这个项目最值得先看的部分。打开 SQL 文件核心是会员表、员工表、衣服洗涤记录、价格表、充值流水这几张表表和表之间通过会员 ID 关联。看脚本时重点看字段没时间把每条 SQL 都跑一遍但字段设计能直接告诉你业务边界。-- 会员表userName 是登录名balance 是余额 CREATE TABLE member ( id INT PRIMARY KEY AUTO_INCREMENT, userName VARCHAR(30) NOT NULL, password VARCHAR(30) NOT NULL, balance DECIMAL(10,2) DEFAULT 0, status INT DEFAULT 1, -- 1 正常, 0 已注销 createTime DATETIME ); -- 洗涤价格表每件衣服按类型定价 CREATE TABLE price ( id INT PRIMARY KEY AUTO_INCREMENT, clothesType VARCHAR(20) NOT NULL, price DECIMAL(10,2) NOT NULL ); -- 洗涤记录表订单流水关联会员和员工 CREATE TABLE wash_record ( id INT PRIMARY KEY AUTO_INCREMENT, memberId INT, employeeId INT, clothesType VARCHAR(20), amount DECIMAL(10,2), status INT DEFAULT 0, -- 0 待取, 1 已完成 createTime DATETIME );逻辑说明member 表里 status 字段对应「注销会员」功能不是物理删除而是软删除这样既能保留历史洗涤记录又能在登录时做状态过滤。price 表是典型的课程设计风格把衣服类型和单价放一起比单独做字典表更直观。wash_record 表是业务核心收益查询和洗涤记录管理都靠这张表聚合。参数说明DECIMAL 不能换成 FLOAT余额和收益涉及金额浮点运算会出精度问题这是我从项目里看到的处理方式也是实际项目中必须留意的点。建表脚本里如果有外键约束导入时注意先删旧表再执行。3. 本地复现JDK、Tomcat、MySQL 的版本搭配与部署顺序源码再完整跑不起来等于零。这一章直接按我自己的复现路径把环境变量、导入步骤、启动命令全部贴出来照做就行。版本搭配是第一道坎JDK 8 Tomcat 8.5 MySQL 5.7 是这套源码最保险的组合如果你已经装了 JDK 17 或 MySQL 8后面有对应的处理办法。3.1 环境准备与数据库导入先把环境理清再动手。JDK 8 和 Tomcat 8.5 下载解压安装后关键变量有这么几个# Linux / macOS 环境变量示例Windows 在系统属性里配同样的键值对 export JAVA_HOME/usr/local/jdk1.8.0_281 export CATALINA_HOME/usr/local/apache-tomcat-8.5.100 export PATH$JAVA_HOME/bin:$CATALINA_HOME/bin:$PATH # 验证 java -version startup.sh # 启动 Tomcat默认 8080 端口逻辑说明Tomcat 的 startup.sh 依赖 CATALINA_HOME 和 JAVA_HOME 两个变量配错任何一个都会启动失败。我一般先把 Tomcat 单独启动一次看到控制台输出Server startup in ...再继续配项目这样后续报错时能快速定位是环境问题还是项目问题。参数说明8080 端口如果被占用改 conf/server.xml 里的 Connector 端口 8080 换成 8081 或 9090。修改后需要重启 Tomcat 才生效同时访问地址也要跟着变。数据库导入用命令行最直接MySQL 8 的 zip 免安装版也是一样的玩法先初始化再启动服务。导入命令mysql -u root -p jsp_cleaner.sql提示如果 SQL 脚本里有CREATE DATABASE语句导入前先确认库名与项目 jdbc.properties 里的库名一致这是我拆源码时最先核对的位置。3.2 IDEA 里配置 Tomcat 与 Artifact源码不是 Maven 工程IDEA 里跑要手动配置 Artifact。我比较推荐的方法是在 IDEA 里新建一个 JavaWeb 项目然后把源码的 src 拷贝到 src 目录把 web 目录下所有内容覆盖到 web 目录。这样 IDEA 会自动生成 Artifact。依次打开 File - Project Structure - Artifacts确认输出类型是 Web Application Exploded然后在 Run - Edit Configurations 里新增 Tomcat Server - LocalTomcat Server Settings: Application Server: 选你本地的 Tomcat 8.5 URL: http://localhost:8080/jsp_cleaner/ Server - On Update Action: Redeploy Deployment - 点击 选 Artifact - 加 /jsp_cleaner逻辑说明Deployment 里的 Application Context 必须写/jsp_cleaner这决定了访问路径。如果不写默认是/那登录后跳转的地址就和实际部署路径对不上静态资源也会全部 404。这个坑我在别的项目里踩过多次每次都是因为 IDEA 自动部署的上下文和源码里 basePath 不一致。参数说明JDK 版本在 Project Structure - Project - SDK 里选 1.8如果本机只有 JDK 17也可以在同一位置添加 1.8 的 SDK 路径。编译级别选 1.8别选更高版本否则 javax.servlet 相关 API 可能因为模块化限制出现编译错误。启动前准备数据库连接配置。在 src 目录下找到 jdbc.properties 或 DBUtil.java改掉数据库账号密码jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/jsp_cleaner?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456逻辑说明com.mysql.jdbc.Driver 对应 MySQL 5.x 的旧驱动如果数据库是 MySQL 8要改成 com.mysql.cj.jdbc.Driver并加上 serverTimezone 参数。这是老 JSP 项目移植到新 MySQL 时最常见的报错点Character encoding 那一段参数也是防乱码的关键。4. 三角色功能走读订单、余额、收益报表的代码是怎么串起来的整个系统的业务链不复杂但三套角色流程交错新手容易绕晕。我把源码里的核心 Servlet 逻辑按角色拆开讲对应着功能菜单看很快就能明白哪段代码对应哪个操作。管理员管价格和员工员工管洗涤记录会员提交订单和充值主链路就是会员下单 - 员工处理 - 管理员查收益。4.1 管理员角色拦截器、价格更新与收益聚合管理员模块的关键代码在 AdminServlet登录成功后 session 里写入 admin 对象后续通过过滤器做权限判断。看代码片段WebServlet(/admin/*) public class AdminServlet extends HttpServlet { public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String action request.getPathInfo(); if (/updatePrice.equals(action)) { String clothesType request.getParameter(clothesType); double price Double.parseDouble(request.getParameter(price)); PriceDao.update(clothesType, price); response.sendRedirect(priceList.jsp); } else if (/statistics.equals(action)) { ListOrderStat stats OrderDao.statistics(); request.setAttribute(stats, stats); request.getRequestDispatcher(statistics.jsp).forward(request, response); } } }逻辑说明这个 Servlet 用 getPathInfo 做二级路由比在 web.xml 里堆一堆 servlet-mapping 好维护。updatePrice 对应「洗涤价格管理」菜单statistics 对应「收益查询」。注意收益查询不是现场算流水而是调 OrderDao.statistics() 做聚合性能上更合理也符合课设要求的简单高效。参数说明前端表单传过来的 price 是字符串必须 parseDouble但要做一次 NumberFormatException 捕获。这是老项目的通病传非法字符直接 500你可以顺手补一个 try-catch用户体验立刻不一样。4.2 会员与员工注册、余额扣减、洗涤记录状态流转会员的核心操作是提交订单和充值。订单提交的代码逻辑非常典型先查余额余额够了再扣钱、写订单否则提示余额不足public String submitOrder(long memberId, long employeeId, String clothesType, double amount) { Member member memberDao.findById(memberId); if (member.getBalance() amount) { return 余额不足请先充值; } memberDao.deductBalance(memberId, amount); WashRecord record new WashRecord(); record.setMemberId(memberId); record.setEmployeeId(employeeId); record.setClothesType(clothesType); record.setAmount(amount); record.setStatus(0); washRecordDao.insert(record); return 下单成功; }逻辑说明扣余额和插入订单没有放在事务里这是源码的简化做法也是课设项目里常见的处理。真正上线必须加 Transactional 或手动控制 connection.setAutoCommit(false)否则扣款成功但订单写入失败账就平不了。我这里展示的是源码原逻辑复现时保持原样没问题但要意识到这个边界。参数说明employeeId 在提交订单时由前端下拉列表传过来如果员工未分配或者已经被删除这里会查询不到。源码里没有做空指针保护复现时如果页面报错先检查是否漏选了员工这是最常见的人为操作失误。员工角色的「记录管理」就是列表加状态更新核心 SQL 是UPDATE wash_record SET status 1 WHERE id ?把待取的订单改成已完成。列表查询做了分页offset 和 limit 的计算在 PageBean 里用的是一页 5 条或 10 条看前端 JSP 里怎么调 Pager。4.3 前端 JSPEL 表达式与 JSTL 的分工页面层全部是 JSP但业务数据展示没怎么写 Java 脚本而是用 EL 表达式和 JSTL 标签。这对课设来说算比较规范的写法因为 scriptlet 代码多了以后JSP 编译期报错很难定位。看一个片段c:forEach items${sessionScope.member.washRecords} varrecord tr td${record.clothesType}/td td${record.amount}/td td c:if test${record.status 0}待取/c:if c:if test${record.status 1}已完成/c:if /td /tr /c:forEach逻辑说明sessionScope.member 是登录时写入 session 的完整 JavaBean里面已经通过 DAO 把 washRecords 列表装配好。这种写法在数据量小的时候很舒服但如果会员订单数量大session 里挂着一整张订单表就不合理。更好的做法是只在需要时通过订单 ID 去查页面只展示当前页数据。参数说明c:forEach 的 items 属性值来源决定数据流方向。如果是 request 作用域那说明 Servlet 在转发前把查询结果放进了 request如果是 sessionScope说明登录或刷新时已经全量加载。理解这一点调试时才能判断是 DAO 层查询问题还是 JSP 页面取值问题。5. 项目复现踩坑记录乱码、版本不兼容、JS 失效的五个实战问题这套源码我在 Windows 和 macOS 上各跑了一遍新手最容易卡死的五个问题基本固定。每条按现象、原因、解决三步写这些坑解决了项目复现基本就顺了。5.1 页面中文全是问号或者数据库中文乱码现象启动项目后页面显示的中文内容变成问号登录后会员姓名显示乱码。原因三层乱码叠加。JSP 页面没有统一编码Servlet 返回 response 时没设置 ContentType 为 UTF-8MySQL 连接串没带 characterEncodingutf8。这三个位置只要有一个不一致就会显示乱码或入库乱码。解决第一步把每个 JSP 页面头部的contentTypetext/html; charsetUTF-8pageEncoding 改为 UTF-8其他同理。第二步在 Servlet 的 doGet/doPost 入口加上request.setCharacterEncoding(UTF-8); response.setContentType(text/html;charsetUTF-8);。第三步确保 jdbc.properties 里连接串带了?useUnicodetruecharacterEncodingutf8然后重建数据库表重新导入。这三步做完乱码不会再出现。5.2 Tomcat 10 启动直接报 ClassNotFound现象启动项目时控制台报java.lang.ClassNotFoundException: javax.servlet.Filter页面全部 404。原因从 Tomcat 10 开始Servlet API 从 javax 包迁移到 jakarta 包而源码里的 import 语句全是 javax.servlet所以加载不到类。很多新手直接下载最新版 Tomcat 10图省事结果最先卡在这里。解决换成 Tomcat 8.5 或 9.0 版本重新配置 IDEA 里的 Application Server。如果必须用 Tomcat 10那就全局替换 import 为 jakarta还要替换 web.xml 头部的命名空间工作量不小不推荐为了一个课设项目这么做。版本选型本身就是避坑。5.3 访问登录页正常登录后跳转 404现象在浏览器输入http://localhost:8080/jsp_cleaner/login.jsp打开正常输入账号密码后跳转地址栏出现了http://localhost:8080/login.jsp之类的不带项目上下文的路径页面 404。原因JSP 页面里用了以/开头的绝对路径比如/login.jsp而这个/在 Tomcat 里指向的是根目录不是项目部署路径。源码里虽然大部分用了 basePath 变量但仍有个别跳转是硬编码的绝对路径。解决统一用 basePath 拼接。在每个 JSP 页面开头加如下脚本片段% String basePath request.getScheme() :// request.getServerName() : request.getServerPort() request.getContextPath() /; %然后把a href/xxx.jsp改成a href%basePath%xxx.jspredirect 同理。刷卡到这类 404先按这个规则排查一遍硬编码路径。5.4 图片和 CSS 能加载但 JS 事件全部失效现象页面样式正常但点击按钮没有响应浏览器控制台报 JS 文件 404。原因JS 文件引用路径写的是相对路径当浏览器地址栏带了长路径时相对路径解析到错误位置。比如当前 URL 是/jsp_cleaner/user/order.jsp相对路径js/common.js会解析到/jsp_cleaner/user/js/common.js而实际文件在/jsp_cleaner/js/common.js于是 404。解决页面里所有 script 和 link 标签统一改成基于 basePath 的绝对路径。例如script src%basePath%js/common.js/script这类问题在传统 JSP 多级目录结构下高发路径写法有没有混用 basePath从这个角度排查最有效。5.5 数据库连接超时或 Access denied现象Tomcat 启动没问题但访问首页或登录时页面报错控制台抛Cannot create PoolableConnectionFactory或Access denied for user rootlocalhost。原因jdbc.properties 里的账号密码和本地数据库不一致。老项目源码里默认密码往往是很短的老密码格式而 MySQL 8 默认账号密码加密方式为 caching_sha2_password旧驱动连不上或者密码本身就不对。解决第一步直接用命令行登录 MySQL确认密码正确。第二步把 jdbc.properties 里的 driver 换成com.mysql.cj.jdbc.DriverURL 加serverTimezoneAsia/Shanghai。第三步如果还报加密方式问题执行 SQL 调整 root 用户加密规则ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码; FLUSH PRIVILEGES;逻辑说明这个设置让 MySQL 8 兼容老驱动的密码校验方式改完重启项目即可连通。这不是源码的问题是新旧数据库版本之间的兼容问题遇到先按这个顺序排查比自己乱改代码高效得多。6. 拿这套源码改课程设计登录鉴权 订单状态机的最小改造源码能跑通只是第一步课设答辩时老师更关心你「改了什么」。这里给两个低成本改造点代码量不大但能明显提升项目的完成度一个是登录鉴权一个是订单状态机。登录鉴权当前是每个 Servlet 里自己查 session管理员的每个操作都要重复判断是否登录。最小改造是加一个 Filter统一拦截所有/admin/路径WebFilter(/admin/*) public class AdminAuthFilter implements Filter { public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; HttpSession session req.getSession(false); if (session null || session.getAttribute(admin) null) { ((HttpServletResponse) response).sendRedirect(req.getContextPath() /login.jsp); return; } chain.doFilter(request, response); } }逻辑说明这个 Filter 拦截所有/admin/*请求检查 session 里有没有 admin 对象。没有就强制跳回登录页有才放行。改完之后管理员相关的 Servlet 里那段重复的登录判断代码可以删掉代码变得更干净答辩时讲起来也有说头。参数说明req.getContextPath()用于拼出项目上下文路径避免部署名不同导致跳转 404。session 判断要放在 Filter 里而不是 Servlet 里这样新加的后台功能天然带鉴权不用每个方法都写检查。订单状态机是另一个值得改的点。当前源码里订单只有「待取 / 已完成」两态你可以扩展成五态已提交 - 洗涤中 - 待取 - 已完成 - 已取消。改动集中在 wash_record 表的 status 字段和 DAO 层。public static final int STATUS_SUBMITTED 0; public static final int STATUS_WASHING 1; public static final int STATUS_READY 2; public static final int STATUS_DONE 3; public static final int STATUS_CANCELED 4;逻辑说明状态用常量定义后所有判断都引用常量比裸写数字可读性强很多。再配合一个updateStatus(int id, int fromStatus, int toStatus)方法让状态只能从指定前置状态迁移到下一状态比如只有 READY 状态的订单才能改成 DONE直接改成 CANCELED 会被拒绝。这在数据库层叫乐观状态机能有效防止员工误操作把已完成订单改成已取消。参数说明如果需要前端看到状态变化时间再加一个updateTime字段每次更新状态时写入当前时间页面展示时直接用时间戳排序比用创建时间判断进度直观得多。这套改造做完你能在答辩时说清楚三件事项目本身能跑通、你理解每个角色之间的关系、你做了带约束的流程改造。源码里的套路学会了换一个别的管理系统数据库脚本和 Servlet 结构都是同一套打法。我后来自己写课设时也强制把 Filter 鉴权和状态流转先搭好再写页面从那以后项目翻车的次数明显少了希望帮到你。本文还有配套的精品资源点击获取
