JSP+SSH+MVC商城源码解析：从分层架构到部署避坑指南

简介：这是一个面向Java Web初学者的水果销售商城系统完整源码包，基于SSH框架与MVC分层设计，涵盖普通用户注册登录、商品分类浏览、购物车下单、订单查询及管理员端的水果增删改查、分类/订单/用户管理等核心业务模块，很适合用做课程设计或毕业设计的练手项目。资源包共139个文件，约2.7MB，主要包含25个JSP页面、24个Java类及对应Class文件、19个XML配置、5个CSS样式、4个JavaScript脚本和1个SQL数据库脚本等，其中XML与properties文件用于Struts与Hibernate等框架的集成配置，SQL脚本可帮助快速初始化数据库。目前已有775人学习/下载。通过该源码可系统理解SSH整合流程、MVC请求处理链和JavaWeb项目目录结构，同时管理员与用户双角色设计也为权限管理和业务分层提供直接参考，适合希望以完整项目提升实战能力的开发者。

1. 一份能跑通的 JSP + SSH + MVC 商城源码，先从这儿下手

拿到这份 java ssh mvc 方向的 JSP 商城源码时，你多半正处在毕业设计选题或者 javaweb 课设的关头上。学完了 Java 基础和 JSP 语法，能写独立页面，但 Model2 模式下登录、购物车、订单这些模块到底怎么用 SSH 串起来，对很多人来说还是个黑匣子。这份《水果销售商城系统》就是用 Struts2 + Spring + Hibernate 组装出的完整闭环：前台用户注册登录、浏览水果、分类查看、加购下单、查订单、改个人信息；后台管理员维护水果信息、商品分类、订单状态和用户列表。它适合两类人：一类是正需要交 JavaWeb 毕设的学生，另一类是刚学完框架想看看「别人怎么分层」的 Java 后端初学者。下面按我拆这套源码的顺序，从架构读法讲到部署步骤，再讲业务链路和容易翻车的位置。

2. 先读架构再碰代码：SSH 分层与 MVC 边界怎么落地

2.1 从 class 文件名单反推项目分层

解压后你会看到一串编译后的 class：OrderDao、BookDao、BookAction、OrderAction、UserAction、CommentDao、UserDao、CommentAction、RoomDao、TypeAction。这串名字本身就是分层说明书。

这套资源是典型的 SSH（Struts2 + Spring + Hibernate）三层，Action 结尾的是控制层类，Dao 结尾的是数据访问层类。BookAction 管水果商品展示，OrderAction 管订单流程，UserAction 管注册登录和资料修改，CommentAction 管评论，TypeAction 管分类。OrderDao、BookDao、UserDao 则对应订单、商品、用户三张核心表的持久化操作。RoomDao 这个命名是原作者的模块习惯，对应的是后台某个业务实体，你在源码里碰到类似名字时，先去 Spring 的 applicationContext.xml 里看 bean 的注入关系，比盯着类名猜要快得多。

<!-- struts.xml 片段，注意 action 的 class 指向 Spring 容器中的 bean --> <struts> <package name="fruit" namespace="/" extends="struts-default"> <action name="book_*" class="bookAction" method="{1}"> <result name="success">/front/bookList.jsp</result> <result name="detail">/front/bookDetail.jsp</result> </action> <action name="order_*" class="orderAction" method="{1}"> <result name="success" type="redirect">order_list</result> </action> </package> </struts>

这个配置里最关键的是class属性不写全类名，而是写 Spring 容器里的 bean id。Struts2 收到book_list.action这样的请求时，通过通配符把{1}解析成方法名list，再反射调用 BookAction 里的 list()。result 的 name 对应 Action 方法返回的字符串，success 后面接的要么是 JSP 路径，要么是 redirect 类型实现「提交后跳转」避免表单重复提交。

2.2 Service 层在哪：Spring 容器怎么把 Action 和 Dao 粘起来

网上很多 SSH 课设把 service 和 dao 混在一起写，这套源码从命名看没有单独的 XxxService 文件，而是让 Spring 以 bean 方式管理 action 和 dao。所以你在配置里会看到类似下面这样的 applicationContext.xml 片段。

<bean id="bookDao" class="com.fruit.dao.impl.BookDaoImpl"> <property name="sessionFactory" ref="sessionFactory"/> </bean> <bean id="bookAction" class="com.fruit.web.action.BookAction" scope="prototype"> <property name="bookDao" ref="bookDao"/> </bean>

注意两个细节：一是通过setSessionFactory注入 Hibernate 的会话工厂，Dao 实现类里用getHibernateTemplate()操作数据库；二是 action 的 scope 配成 prototype。因为 Struts2 的 Action 是每个请求 new 一个实例，如果配成默认单例，多线程下成员变量会互相覆盖。很多人在这个点上翻车，页面数据显示串号，就是 scope 配错了。

判断标准：同一个用户连续访问两次页面，如果看到别人的购物车数据，先看 scope 是不是 prototype。

2.3 MVC 边界：JSP 里能出现多少 Java 代码才算合格

这套源码的 JSP 页面基本遵循了 Model2 规范，页面里主要用 JSTL 和 EL 表达式取值，业务逻辑都收在 Action 里。你打开 front/bookList.jsp 大概率能看到这样的结构。

<c:forEach items="${pageBean.list}" var="book"> <div class="fruit-item"> <p>${book.name}</p> <p>￥${book.price}</p> <a href="order_add?bookId=${book.id}">加入购物车</a> </div> </c:forEach>

这里的pageBean是 Action 里 set 到 request 域的对象，MySQL 查出来的数据经过 Dao 到 Action 再到 JSP，方向是单向的。能这样写的前提是 Action 把查询结果封装成了 PageBean，里面包含 list、当前页码、总页数三个字段。如果你在 JSP 里看到大段 scriptlet（<% ... %>）写 JDBC 代码，那属于 Model1 的写法，维护成本很高。

这套 MVC 分工对你回答面试题也有直接帮助：JSP 只做渲染，Action 做路由和参数组装，Model 交给 Hibernate 的实体映射。把这三条界线说清楚，比死记 mvc设计模式 的定义有用得多。

3. 部署与运行：MyEclipse 10 + MySQL + Tomcat 的兼容组合与启动步骤

3.1 环境配对先定死，别用最新版硬刚

旧 SSH 项目对环境挑剔，不是下载最新版就能跑。下面是这套源码比较稳妥的组合，建议按表来，能省掉大量排错时间。

注意：用 IntelliJ IDEA 也能导，但需要手动给项目加 Spring、Struts2、Hibernate 的依赖包，包版本不一致可能启动直接报错。我建议第一次跑通先用 MyEclipse 10，跑通后再迁到别的 IDE。

3.2 导入、建库、改连接串、部署四步走

第一步，把 .rar 解压到没有中文和空格的路径下，比如D:\fruit-shop。路径里带中文会导致 MyEclipse 编译后资源加载失败。

第二步，在 MyEclipse 里执行 File → Import → Existing Projects into Workspace，选择解压目录。如果你的 MyEclipse 没装 STS 等插件，项目会显示为普通 Java 项目，这正常，只要能看到 WebRoot 和 src 两个目录就行。

第三步，启动 MySQL 创建数据库。项目里一般会附带 fruit.sql 之类的脚本，找不到就新建一个名为 fruit 的库，字符集选 utf8，然后手动建表和造数据。

-- 商品表，字段以源码中的 Book 实体为准 CREATE TABLE `book` ( `id` int(11) NOT NULL AUTO_INCREMENT, `name` varchar(50) NOT NULL COMMENT '水果名称', `price` decimal(10,2) NOT NULL COMMENT '单价', `type_id` int(11) DEFAULT NULL COMMENT '关联分类', `stock` int(11) DEFAULT '0' COMMENT '库存', `img` varchar(200) DEFAULT NULL COMMENT '图片路径', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

第四步，找到 src 下的数据库配置文件，通常是 jdbc.properties 或 db.properties，改连接地址、账号密码。

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/fruit?useUnicode=true&characterEncoding=utf8 jdbc.username=root jdbc.password=123456

这里characterEncoding=utf8和useUnicode=true是专门防中文乱码的，mysql-connector-java 5.x 不需要加 serverTimezone 参数。改完后右键项目 → Run As → MyEclipse Server Application，选 Tomcat 7 启动。

提示：启动时控制台如果刷出大量log4j:WARN，不影响运行，那是日志配置没生效，不是故障。

3.3 首次启动失败的三个定位手段

第一个常见问题：8080 端口被占。用netstat -ano | findstr 8080查端口占用，找到对应 PID 后要么结束进程，要么把 Tomcat 的端口改成 8081。改端口在 server.xml 里，把三个 Connector 标签里的端口号统一替换。

第二个常见问题：浏览器访问返回 404。先确认访问路径是http://localhost:8080/工程名/，工程名是 WebRoot 所在的上下文根，不是项目名。如果项目名是 FruitShop，部署后访问根路径通常是http://localhost:8080/FruitShop/。可以在 MyEclipse 的 Project Properties → MyEclipse → Web 里改 Context Root。

第三个常见问题：控制台报java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener。这说明 spring-web 相关的 jar 没进 WEB-INF/lib。旧项目经常因为导入时没有勾选「复制依赖到 lib」，解决方法是右键项目 → Properties → Deployment Assembly，确认 jar 都挂在 WEB-INF/lib 下。

4. 业务模块脉络：从注册下单到后台管理的关键链路与改法

4.1 用户侧主线：注册 → 浏览 → 加购 → 下单 → 查订单

用户侧的核心链路集中在 UserAction、BookAction 和 OrderAction 里。以「用户下单」为例，整个过程是一条清晰的调用链：JSP 页面提交订单 → Struts2 拦截到order_add.action→ OrderAction 的 add() 方法接收参数 → 调用 OrderDao 保存订单主表 → 同时往订单明细表插记录 → 跳转结果页面。

public String add() { // 从 session 里拿当前登录用户 User user = (User) ServletActionContext.getRequest().getSession() .getAttribute("loginUser"); if (user == null) { return "login"; // 未登录直接回登录页 } // 购物车一般存在 session 里，key 固定为 cart Map<Integer, CartItem> cart = (Map<Integer, CartItem>) ServletActionContext.getRequest().getSession().getAttribute("cart"); double total = 0.0; for (CartItem item : cart.values()) { total += item.getPrice() * item.getCount(); } Order order = new Order(); order.setUserId(user.getId()); order.setTotal(total); order.setStatus(1); // 1 表示待发货 orderDao.save(order); // 保存订单明细，这里省略循环详情代码 return "success"; }

注意这段代码里的关键点：session 里同时放着 loginUser 和 cart 两个对象。购物车用 Map 存，key 是商品 ID，value 是 CartItem，CartItem 里包含商品快照（名称、单价、数量）。这里有一个值得学习的细节：下单时把商品名称和单价冗余存进订单明细，而不是下单后再去查 book 表——因为商品价格和名称可能被后台修改，订单需要保留下单那一刻的快照。

4.2 管理侧权限：拦截器与角色判断

后台的管理员操作集中在 UserAction、TypeAction 和订单管理相关方法里。这套源码的权限控制一般通过两个手段实现：一是登录时在 session 里存 user 对象，二是用过滤器或拦截器校验 session 里有没有 user，以及 user 的 role 是不是管理员。

<!-- struts.xml 中配置拦截器栈，示例 --> <interceptors> <interceptor name="adminCheck" class="com.fruit.interceptor.AdminInterceptor"/> <interceptor-stack name="myStack"> <interceptor-ref name="defaultStack"/> <interceptor-ref name="adminCheck"/> </interceptor-stack> </interceptors> <!-- 只对 admin_ 开头的 action 应用 --> <action name="admin_*" class="adminAction" method="{1}"> <interceptor-ref name="myStack"/> <result name="success">/admin/index.jsp</result> <result name="login">/login.jsp</result> </action>

AdminInterceptor 里做的事情是：从 session 取 loginUser，为空就返回 login，不为空继续判断 role 字段。如果源码里写的是 Filter，效果是一样的，只是配置位置在 web.xml。你要改权限规则时，只需要记住一个原则：所有进入 admin 前缀的请求必须过这一道校验，千万不要在 JSP 页面里靠「不显示入口链接」来隐藏后台，那只是前端隐藏，直接输 URL 还是能绕过。

4.3 二次开发入口：改字段、加支付、挂评论

改一个商品字段要动三处：MySQL 表、Hibernate 映射文件（Book.hbm.xml 或 Book 实体注解）、前台 JSP 页面。以给商品加「产地 origin」字段为例，先执行ALTER TABLE book ADD origin VARCHAR(50)，再在映射文件里加<property name="origin"/>，最后在 JSP 的详情页补展示标签。

评论模块对应 CommentAction 和 CommentDao，逻辑一般是这样：用户未登录也能看评论，但发评论必须登录。新增评论时，页面提交两个参数：bookId 和 content，Action 里从 session 取 loginUser 填 userId，然后调 CommentDao.save()。

RoomDao这类看起来和水果无关的类，建议你去读一下它对应的实体和表结构，多半是后台的某个业务表（比如库存区域或收货地址），读懂了顺便知道这套源码的实际表结构不止商品、订单、用户三张。

5. 避坑排查：旧 SSH 项目移植到新环境最容易翻车的五个位置

5.1 UnsupportedClassVersionError：JDK 版本太新

现象：Tomcat 启动时控制台报UnsupportedClassVersionError: ... Unsupported major.minor version 51.0，页面 500。

原因：class 文件编译用的 JDK 版本高于当前运行环境的 JDK。major version 51.0 对应 JDK 7，如果你用 JDK 8 编译过这个项目，换成 JDK 7 启动就会报这个错。

解决：统一环境。MyEclipse 10 自带的编译器级别调到 1.7，Tomcat 7 用 JRE 1.7 运行。如果必须用 JDK 8，那要把项目里所有源码重新编译一遍，而不是只替换某个 class。

5.2 MySQL 5.7+ 启动报 SSL 警告或时区错误

现象：控制台警告Establishing SSL connection without server's identity verification is not recommended，部分版本直接报The server time zone value '�й���׼ʱ��'。

原因：mysql-connector-java 5.x 在 MySQL 5.7+ 上默认尝试 SSL 连接，且 MySQL 8 以上对时区参数要求严格，导致连接失败。

解决：在连接串上加useSSL=false&serverTimezone=Asia/Shanghai，但注意 5.x 驱动不一定认 serverTimezone，最省事的是把 MySQL 换成 5.5~5.7 版本。

5.3 Hibernate 方言配错导致 SQL 分页语法不对

现象：查询列表时报SQLGrammarException: ... LIMIT ...附近语法错误，或者分页功能直接失效。

原因：hibernate.cfg.xml 里配置的hibernate.dialect写成了 OracleDialect 或泛化方言。Hibernate 会根据方言生成不同风格的 SQL，MySQL 方言才会生成 LIMIT 子句。

解决：检查 hibernate.cfg.xml，确保配的是org.hibernate.dialect.MySQLDialect。旧项目里如果写了MySQLInnoDBDialect也没问题，那只是指定存储引擎的变体。

5.4 图片和 CSS 全部 404

现象：页面能打开，但所有图片、CSS、JS 资源全部加载失败，看 Network 面板全是 404。

原因：JSP 里的资源路径写的是/images/xxx.jpg这种以斜杠开头的绝对路径，部署后的上下文根是/FruitShop，浏览器在http://localhost:8080/images找，自然找不到。

解决：全局搜索 JSP 里src="/和href="/，改成${pageContext.request.contextPath}/前缀。

<!-- 改前 --> <link rel="stylesheet" href="/css/style.css"> <!-- 改后 --> <link rel="stylesheet" href="${pageContext.request.contextPath}/css/style.css">

5.5 登录后跳转回登录页，没有任何报错

现象：输入正确的账号密码，点击登录后页面闪一下又回到登录页，控制台没有异常堆栈。

原因：登录成功的 result 配的是type="redirect"跳转到某个 action，但那个 action 的方法返回了login，比对 session 里还是没有用户。常见情况是登录成功后存 session 的 key 写错了，比如 Action 里存adminUser，拦截器里取loginUser，永远取不到。

解决：全项目搜索setAttribute和getAttribute，把 key 统一。这一步没有捷径，逐个人核对，重点是 UserAction 登录方法、拦截器、JSP 头部取用户名的三处。

6. 验证与扩展：一条主线测完全部功能，再决定往哪个方向改

6.1 用「水果上架到订单完成」的完整流程做回归验证

部署跑通之后，别急着改代码，先按真实业务流程走一遍。我习惯用一套固定的验证清单覆盖主要功能：

这 8 步走完，登录、商品、购物车、订单、后台管理、用户资料六大模块都覆盖到了，任一步卡住，说明对应模块的前后端链路有断点。验证时建议开着浏览器开发者工具，Network 面板里任何 4xx/5xx 都要追到原因，而不是刷新一下继续。

6.2 三个低成本小改造，让这套源码变成你的作品

第一个值得做的是把固定数量的首页推荐改成从数据库读取，这样能顺便理解 TypeAction 的用途。第二个是把密码明文存储改成 MD5 + 盐值加密，这个改动只涉及 UserAction 注册登录方法和 user 表两个字段，但能在答辩时讲出「安全考虑」。第三个是给 OrderAction 增加一个订单状态流转的日志字段，比如记录下单时间和发货时间，这对理解 Hibernate 的日期类型映射有帮助。

其中第二个改造注意幅度，老项目里如果用户表已经有明文数据，不要直接删字段，加一个password_salt字段兼容旧数据，登录时先判断是否走新逻辑。

复盘我拆过的十几个 JavaWeb 毕设项目，只要是 SSH 架构的，踩坑位置八成都在环境版本搭配和 session 命名不统一这两类问题上。这套水果商城理论上 30 分钟内能跑通，如果超过这个时间还没看到首页，说明某个环节偏离了前面说到的部署路径。从那以后，我拿到任何一套毕业设计源码，第一步永远是先建库跑起来，再谈读代码——代码可以慢慢懂，环境问题不值得熬夜。希望帮到你。

本文还有配套的精品资源，点击获取