基于JSP+Servlet+MySQL的蛋糕商城系统：架构拆解与部署避坑指南

简介一套完整可运行的基于JSP的蛋糕商城系统项目包面向JavaWeb初学者及课程设计/毕业设计人员用于学习电商系统的前后端交互与部署流程。项目覆盖商品管理、分类管理、订单管理等核心模块并配有SQL数据库脚本包含用户、商品、订单等表结构便于直接部署和二次开发。压缩包共408个文件大小约21.93MB其中包含55个Java源码、58个JSP页面、110个编译后的class文件以及XML配置、JAR依赖库、JS/CSS/图片等前端资源目录结构清晰可对照学习Web项目的分层组织方式。目前已有3240人学习下载非常适合用来掌握JSPServletJDBC的典型开发模式并结合数据库设计完成一个可运行的在线蛋糕商城。资源内附带完整源码和数据库脚本能在此基础上扩展支付、会员等功能是实践性较强的JavaWeb项目参考。1. 基于 JSP 的蛋糕商城系统能跑通、能二次改的完整电商示例如果你学过 JavaWeb 但没完整做过一个项目或者正在找课程设计/毕业设计的参考源码这个基于 JSP Servlet MySQL 的蛋糕商城系统是值得花一个晚上去跑通并拆开看的。它不是那种只给你几个页面截图的半成品而是包含了完整的前后台交互逻辑用户浏览商品、下单管理员后台做商品增删改、分类维护、订单发货所有数据落在 MySQL 里。整个项目基于 JavaWeb 经典三层结构代码量不大但电商系统该有的主链路一条不少——商品、分类、订单三大模块闭环。拿它做学习模板比对着教程敲一百遍 CRUD 都管用。2. 系统结构拆解从前端 JSP 到数据库表的完整调用链2.1 MVC 分层JSP 只负责展示Servlet 只做路由DAO 只碰数据这个蛋糕商城系统是典型的 JSP Servlet JavaBean 的 MVC 结构虽然不像 Spring 那样有 IOC 容器和拦截器但分层思路是一样的。拿到源码后你会在包里看到GoodsDao、GoodsService、AdminGoodsAddServlet、AdminGoodsEditServlet、OrderDao这些类名字就把职责写清楚了Dao结尾的类负责操作数据库Service结尾的类负责业务逻辑组装Servlet结尾的类负责接收 HTTP 请求并返回响应。第一次看源码的人最容易犯的错是到处找“业务逻辑写在哪儿”其实顺着 JSP 表单的action属性找到对应 Servlet再跟踪它调用了哪个 Service 和 Dao整条链就清楚了。比如管理员添加一个蛋糕商品的完整链路是这样的后台的goods_add.jsp页面提交表单action指向AdminGoodsAddServletServlet 先把请求参数蛋糕名、价格、库存、分类 ID、图片路径封装成Goods实体对象然后调用GoodsService的添加方法Service 内部再调用GoodsDao.insert()把数据写进数据库最后 Servlet 重定向回商品列表页。每一步的职责单一出了问题也好定位——页面没跳转就查 Servlet 映射数据没写进去就查 SQL 语句或者数据库连接。这样的分层结构对学习者的价值在于它有清晰的“责任边界”。你可以只改 JSP 页面调整界面样式不影响后端逻辑也可以只替换 DAO 层的 SQL 换成其他数据库方言不影响前端展示。我一般建议拿到源码后先不急着读代码而是画一张“页面 → Servlet → Service → DAO → 数据表”的调用关系图半小时画完这张图对整个系统的理解就超过一半了。2.2 数据库设计商品表、订单表、分类表的字段怎么定义才够用系统提供的 SQL 文件是建库建表的脚本用 Navicat 或者命令行执行后就能得到完整的数据库结构。核心表大致有三张商品表goods、分类表category、订单表orders。商品表至少要包含id主键自增、name商品名称、cover图片路径、price价格、stock库存、category_id关联分类表的逻辑外键和create_time之类的常用字段。分类表不复杂但注意id和name要对应好因为商品表通过category_id关联分类如果两张表的 ID 对不上商品在前台就会显示成“无分类”。订单表是这三个模块里字段最讲究的因为它直接关系到发货流程的状态流转。一个能用的订单表至少要有order_id订单编号、user_id下单用户、total_price订单总价、status订单状态、create_time下单时间。这里的status字段是整个订单管理模块的关键一般用整型数字表示状态更利于扩展比如0表示待发货1表示已发货2表示已完成。有经验的开发者不会用字符串存状态因为一旦你输入规范不统一——“待发货”和“待发活”这种笔误会让数据彻底乱掉。用数字存状态然后在 Service 层写状态转换的方法才是工程上更扛造的做法。来看一段从GoodsDao提取出来的典型查询 SQL这是商品列表分页查询时最常用的写法SELECT id, name, cover, price, stock, category_id, create_time FROM goods WHERE category_id ? ORDER BY create_time DESC LIMIT ?, ?;第一行的?是分类 ID第二行两个?分别是分页的起始位置和每页条数。这里有个实际开发中的坑MySQL 的LIMIT第一个参数是偏移量第二个参数才是条数很多人把这两个参数传反了结果第二页永远显示的是同一批数据。看这个系统源码时注意它是怎么传递这两个参数的理解清楚后你在 Spring Boot 写 MyBatis 分页时也不会混。2.3 购物车与下单Session 与数据库表的分工逻辑购物车功能是这个系统里比较值得细看的部分。它没有把购物车设计成一张持久化表而是用 Session 保存临时的购物车数据——用户选好蛋糕、调整数量、最后统一结算。这种方式的好处是实现简单用户没登录也能往购物车里加东西最后强制跳到登录页去结算缺点也一样明显Session 一失效购物车就清零用户关个浏览器就得重新挑一遍。下单动作触发时系统从 Session 里取出购物车数据计算出总金额生成一条订单记录写入订单表同时在商品表和订单明细表里记录相关信息这个系统如果没做订单明细表只是直接扣库存并生成总订单说明它定位在“教学示例”而非“生产可用”你看源码时要注意这一点。这里我建议你注意一个细节下单之后代码里是先扣库存再生成订单还是先生成订单再扣库存如果先扣库存但订单生成失败库存就白白少了如果先生成订单后扣库存库存不足时订单就成了无效数据。老项目的常见做法是先检查库存充足再扣减然后生成订单三者放在同一个事务里——虽然 JSP 原始 JDBC 写事务看起来很繁琐但这是不该省的一步。Connection conn null; try { conn DBUtils.getConnection(); conn.setAutoCommit(false); // 开启事务 // 第 1 步检查并扣减库存 goodsDao.reduceStock(conn, goodsId, count); // 第 2 步生成订单主记录 orderDao.insert(conn, order); // 第 3 步生成订单明细 orderItemDao.insert(conn, goodsId, count, price); conn.commit(); // 全部成功才提交 } catch (SQLException e) { if (conn ! null) { conn.rollback(); // 任何一步失败回滚所有操作 } e.printStackTrace(); } finally { if (conn ! null) conn.close(); }这段代码是从经典 JavaWeb 项目里抽取出来的事务模板核心是setAutoCommit(false)关闭自动提交后手动控制commit和rollback。初学者最容易漏掉finally里的close()导致数据库连接被耗尽生产环境里会把连接池化但手动事务的逻辑是一样的。参数要注意的是reduceStock和insert必须用同一个Connection对象才能保证它们同属一个事务如果你在 DAO 内部各自拿连接事务就切开了这段代码就白写了。3. 把项目跑起来从数据库脚本到 IDEA 配置的完整流程3.1 环境准备与项目导入JDK、Tomcat、MySQL 版本怎么搭配跑这个项目的环境搭配问题很多新手在第一关就会卡住。常见做法是 JDK 8 Tomcat 8.5 MySQL 5.7这套组合兼容性最好。如果你用了 JDK 11 或者 Tomcat 10会碰到一堆javax.servlet包找不到之类的报错因为这些新版本里包名从javax改成了jakarta老项目根本识别不出来。我用 IDEA 导入这个项目时习惯这样操作用File - New - Project from Existing Sources选中根目录IDEA 会自动识别为 Web 项目然后配置Project Structure里的Artifacts把 Tomcat 的依赖加进来最后在Run/Debug Configurations里新建一个 Tomcat Server 指向本地安装路径。数据库导入是最不需要动脑但最容易出错的环节。打开 MySQL 命令行或者 Navicat执行 SQL 脚本文件mysql -u root -p cakeshop.sql密码输入正确后没有报错信息就是导入成功了。有些版本的 SQL 文件开头会有CREATE DATABASE cakeshop; USE cakeshop;这种带建库语句的脚本执行完就不用再手动建库。如果你用的是 Navicat直接右键 - 运行 SQL 文件可以选中脚本执行执行成功后刷新一下就能看到表结构看到goods、orders、category这几张表都在数据库这步算彻底过关。3.2 JDBC 配置修改数据库连接参数的三个必改项源码里的DBUtils或者JDBCUtils类中会有一段数据库连接配置不同项目封装方式不同有的是.properties配置文件有的是写死在工具类里。不管在哪儿你都需要把下面三个参数改成自己电脑的配置private static final String DRIVER com.mysql.jdbc.Driver; private static final String URL jdbc:mysql://localhost:3306/cakeshop?useSSLfalsecharacterEncodingutf-8; private static final String USERNAME root; private static final String PASSWORD 你自己的数据库密码;第一个注意点是DRIVERMySQL 5.7 用com.mysql.jdbc.Driver如果你换成 MySQL 8.x驱动类名要改成com.mysql.cj.jdbc.Driver同时需要把lib下的 mysql-connector-java 的 JAR 包换成 8.x 版本否则会报ClassNotFoundException。第二个注意点是 URL 里的characterEncodingutf-8不加这一句的后果很直接你往数据库里存的中文蛋糕名读出来全是问号。很多号称“系统乱码”的翻车现场90% 都是这个参数没写对。数据库连接不是越复杂越好对于这个系统的规模单连接手动关闭完全够用。但你要明白这个配置的位置和修改逻辑因为所有基于 JSP 的老项目基本长一个样你改过一次之后再碰到类似源码就不会一头雾水。3.3 启动与首轮自测浏览器里验证三条主链路在 IDEA 里配置好 Tomcat 后点击运行按钮启动项目。启动日志里出现Server startup in [xxx] milliseconds表示启动成功如果报端口被占用八成是8080被别的进程占了改一下 Tomcat 配置里的端口即可。控制台能干净地出来启动信息后接下来是手工验证阶段我一般习惯按三条链路走第一条前台登录 → 浏览商品 → 点“加入购物车” → 结算下单。走完这条链路验证普通用户的完整购买流程能被数据库记录。第二条管理员登录后台 → 商品管理 → 添加新蛋糕 → 在页面填信息、上传图片 → 保存后去前台确认新商品展示正常同时数据库goods表里确实多了这一条记录。第三条订单管理 → 看到用户刚下的单 → 执行发货操作 → 状态从“待发货”变成“已发货”。这三条链路都通了系统的核心功能就是健康的。如果你用的是管理员账号测试通常在 SQL 文件里就有预置的admin账号密码数据没有的话就手动往user表里插一条数据注意密码字段是否做了 MD5 加密——做了就用加密后的摘要串没做就直接填明文。判断方式很简单看注册功能的源码里有没有调用加密方法。4. 部署避坑四个最容易翻车的地方与排查手法4.1 报错 404项目没被正确标记为 Web 资源目录现象是运行 Tomcat 后访问首页直接白色报错页面或者 404IDEA 的out目录里只有.class文件而没有 JSP 页面。原因是 IDEA 有时候不会自动把WebContent或webapp目录标记为 Web 资源目录导致 JSP 文件没有被打包进 Artifact。解决办法是File - Project Structure - Artifacts - 选中项目 - Output Layout确认WebContent是否在右侧区域如果不在右键选择Put into Output Root。我一般还会顺手检查Web Fragment里是否有web.xml没有的话整个 Web 应用可能连 Servlet 映射都加载不了。4.2 数据库驱动报错ClassNotFoundException 与版本不匹配现象是点击“添加商品”按钮后控制台报java.lang.ClassNotFoundException: com.mysql.jdbc.Driver。原因是项目的WEB-INF/lib目录下没有放 MySQL 驱动 JAR或者驱动版本和 MySQL 服务端版本差太多。解决方法是下载mysql-connector-java-5.1.49.jarMySQL 5.7 配套放进WEB-INF/lib目录然后重启 Tomcat。如果你用的是 MySQL 8.x驱动 JAR 换用mysql-connector-java-8.0.x.jar代码里的驱动类名也要同步改成com.mysql.cj.jdbc.Driver。这里有个快速验证驱动是否生效的技巧在 JDBC 工具类里写个main方法直接跑能连上数据库说明驱动和连接参数都对再去页面里操作。4.3 中文乱码请求参数和数据库存储两处都要处理现象是添加蛋糕时输入“提拉米苏”在商品列表页显示成“????”或者乱码。原因有两层一层是数据库连接 URL 没加characterEncodingutf-8另一层是 JSP 页面和 Servlet 之间传输请求时编码不一致。JSP 页面顶部要有pageEncodingUTF-8Servlet 里对请求参数做request.setCharacterEncoding(UTF-8)而且这个方法必须在第一个读取参数的语句之前调用顺序错了也是白写。数据库连接 URL 加参数这个事上面已经说过两层都改到位中文字段基本不会出问题。4.4 SQL 脚本执行报错检查 MySQL 版本和文件编码现象是导入 SQL 脚本时提示语法错误而且错误位置往往在脚本靠后的位置。一种可能是你的 MySQL 版本过新某些老语法的写法不被兼容比如旧的TYPEInnoDB已经改成ENGINEInnoDB老脚本里如果写的是前者就会报错。解决方法是全局替换掉这类过时语法。另一种更隐蔽的原因是 SQL 文件本身的编码不是 UTF-8用记事本打开另存为 UTF-8 格式再执行就行。我最推荐的做法是不要用图形化工具导入直接用命令行执行报错信息更原始也更明确能直接定位到具体哪一行 SQL 出了问题。5. 二次开发进阶订单状态机与购物车持久化的改造思路所有 JSP 老项目的通病是业务逻辑“能跑但扛不住量”这个蛋糕商城系统也不例外。如果你想拿这个项目做课程设计的核心或者为毕业设计加亮点我建议从两个方向升级订单状态管理和购物车持久化。订单状态这块现有代码里发货操作是直接修改状态值但真实商城里状态流转必须是一个状态机。我的习惯是定义一个OrderStatus枚举把待发货、已发货、已完成这些状态固定下来然后在 Service 层写状态迁移的方法比如只有“待发货”才能流转到“已发货”禁止跳过中间状态直接改成已完成。别人看你的代码会觉得结构清晰而不是每次改状态都要去翻数据库里现在是什么值。购物车这块就更明显了Session 购物车适合演示但不适合真正做线上。改造成数据库持久化版本核心是加一个cart_item表字段设计大概长这样CREATE TABLE cart_item ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, goods_id INT NOT NULL, quantity INT DEFAULT 1, create_time DATETIME, update_time DATETIME, UNIQUE KEY uk_user_goods (user_id, goods_id) );逻辑上做过一个判断用户没登录也能加购物车但要区分“游客购物车”和“登录用户购物车”。做法是在用户登录时把 Session 里已有的临时购物车数据合并写入cart_item表再清空 Session。这个细节做到位体验上就比原版系统高一个级别。验证改造效果的办法也很朴素把项目打包成 WAR 或直接跑起来连续操作——加入购物车 → 退出浏览器 → 重新登录 → 进购物车看数据是否还在。做这些东西的过程中你会被迫去理解原来代码里哪些环节是“临时绕道”的哪些是“真干活的”这种分辨能力比背多少语法都值钱。从那以后我每次拿到老源码第一件事不是急着跑起来而是先看它的表和字段判断设计了哪些状态再决定从哪入手改。先看懂再动手能少走很多弯路。希望这份笔记对你有用也欢迎你按上面的方式把这个系统拆开自己玩一遍。本文还有配套的精品资源点击获取