简介采用Java、JSP、SSM框架与MySQL数据库实现的网上宠物店毕业设计项目面向计算机相关专业学生、需要完成毕设的应届生以及想熟悉SSM整合流程的开发者可作毕设参考、二次开发或课程项目。压缩包共1539个文件、约99.12MB以Java和JSP源文件、前端脚本与样式、图片素材、SQL数据库脚本为主另含论文文档、开发文档及工程配置与备份文件便于导入开发环境运行学习。系统具备用户注册登录、个人中心、宠物商品分类浏览、购物车管理、订单提交与状态查看以及后台商品上下架、订单处理、用户信息管理等完整模块通过项目可掌握数据库表设计、MyBatis持久层映射、SpringMVC请求分发和Spring业务管理等核心环节同时获得从需求分析到测试交付的毕业设计文档思路。目前已有31人学习下载适合用于毕设选题、中期赶工或作为SSM框架入门到实战的练习项目。1. 网上宠物店毕设项目值不值得下载跑一遍如果你正在找 Java Web 方向的毕业设计题目大概率会在各种资源站刷到“java jsp ssm mysql 097网上宠物店”这类压缩包。它不花哨但技术栈非常典型前端 JSP后端 SSMSpring SpringMVC MyBatis数据库 MySQL。没错这套组合就是国内高校 Java Web 毕设的“标准答案”十年前的课设、五年前的毕设、今天的新题底层骨架几乎没变过。你能从里面看到登录注册、商品列表、购物车、订单、后台管理这些完整闭环麻雀虽小五脏俱全。对想快速搭出一个能答辩、能演示、能二次开发的 web 项目的同学来说这个方向比从头写 Spring Boot 要省心得多但它老所以坑也多。这篇文章我就按这类项目的真实结构把从解压、配置到跑起来、改得动的完整流程写给你。2. 先看家底解压后的目录结构与 SSM 选型逻辑2.1 为什么毕设项目普遍选 SSM 而不是 Spring Boot先说个反直觉的事你现在去搜“java 网站开发”一堆教程都在讲 Spring Boot但真正用来交毕设的老项目大部分还是 SSM。原因不是 Spring Boot 不好而是毕设要求的是“体现 MVC 分层设计”SSM 的 XML 配置文件肉眼可见一层一层摆在那开题报告和答辩 PPT 好写。Spring Boot 把配置都自动化了反而说不清楚“你是怎么把 Spring 整合进来的”。理解这个前提你就能明白这种 zip 包里为什么会有那么多 XML 文件。applicationContext.xml 管 Spring 的 bean 和事务spring-mvc.xml 管控制器和视图解析mybatis-config.xml 管 SQL 映射。整条请求链是浏览器请求到 DispatcherServletSpringMVC→ Controller 调 Service → Service 调 MapperMyBatis→ Mapper 查 MySQL → 结果返回给 JSP 渲染。这套链路看起来绕但它把每层解耦得很干净这也是它能在业务里活这么多年的原因。2.2 拿到压缩包后先按这四块核对工程骨架这种 pet_shop 之类的工程名解压后一般是个 Eclipse 或 IDEA 项目。我不会给你编具体的文件清单但按这类 SSM 项目的通行结构你至少应该找到下面四样东西src目录所有 Java 源码都在里面包结构通常是com.xxx.controller、com.xxx.service、com.xxx.dao、com.xxx.pojo/entity。WebRoot或webapp目录JSP 页面、js、css、静态图片。老 Eclipse 项目叫 WebRootMaven 结构叫 webapp。sql或db目录数据库脚本里面必然是 pet_shop.sql 或类似名字的建库脚本。lib目录老项目的 jar 包会全部堆在这个目录里而不是用 Maven 管理如果是 Maven 项目则是一个 pom.xml。第一件事不是点运行而是打开src看包结构。如果在dao层看到的是UserMapper.java接口加上UserMapper.xml文件说明 MyBatis 走的是 mapper 映射如果只有注解没有 xml那该项目的 SQL 就是写在注解里的。这两种写法的配置方式不一样后面改起来要注意区分。再开一眼web.xml确认 Spring 的监听器、ContextLoaderListener 和 DispatcherServlet 的映射路径各指向哪个配置文件这个文件就是整个 Web 应用的启动入口所有整合配置都由它串起来。2.3 三个关键配置文件先读懂再动手改这类项目你不需要把每一行配置背下来但下面三个文件是你的“命中注定”跑不起来基本都是它们的问题。第一个是jdbc.properties或db.propertiesjdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/pet_shop?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456这里最值得你关注的是 driver 和 url。很多老项目拿到 MySQL 8 上跑第一行还写着com.mysql.jdbc.Driver这个类在 MySQL 8 的驱动包里已经被移除了必须换成com.mysql.cj.jdbc.Driver。同时 MySQL 8 对时区很敏感建议把 url 改成jdbc:mysql://localhost:3306/pet_shop?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai。password 用你自己本机的 MySQL 密码替换这个文件改完数据库连接才有救。第二个是spring-mvc.xml里的视图解析器bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/jsp/ / property namesuffix value.jsp / /bean逻辑解释Controller 返回的字符串名经过 prefix 和 suffix 拼装后变成实际的 JSP 物理路径。比如return index实际渲染的是/WEB-INF/jsp/index.jsp。注意 JSP 放在 WEB-INF 下面可以防止用户直接输入地址访问但 controller 跳转不受影响。第三个是spring-context.xml或applicationContext.xml里的数据源与 Mapper 扫描。我一般会在这块看到 c3p0 或 druid 的配置比如bean iddataSource classcom.mchange.v2.c3p0.ComboPooledDataSource property namedriverClass value${jdbc.driver} / property namejdbcUrl value${jdbc.url} / property nameuser value${jdbc.username} / property namepassword value${jdbc.password} / property nameinitialPoolSize value5 / /bean如果你对这个配置不熟最容易踩的坑是把 driverClass 写成 driverc3p0 会直接报属性找不到连带 Spring 容器启动失败。排查这类问题时不要盲目在网上找答案先看一眼你项目里到底用的是 c3p0、druid 还是 dbcp对应的属性名各不相同。至于连接池里的 initialPoolSize、maxPoolSize 这类参数毕设项目不用调太满默认就够用。3. 把项目跑通数据库初始化到 Tomcat 启动的完整步骤3.1 MySQL 导入建库脚本注意字符集与存储引擎这个项目的灵魂是数据库。拿到 sql 脚本后我习惯用命令行导入而不是直接图形化工具因为报错信息看得更清楚。新建一个叫 pet_shop 的数据库再把脚本导进去。mysql -u root -p mysql CREATE DATABASE IF NOT EXISTS pet_shop DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql USE pet_shop; mysql SET NAMES utf8mb4; mysql SOURCE D:/setup/pet_shop.sql;参数说明character set 指定 utf8mb4 而不是 utf8是为了支持表情符号和更多中文生僻字老脚本可能是 utf8问题不大但新库我建议统一 utf8mb4。SOURCE 后面写你脚本的绝对路径注意路径里别用中文名。导完后可以执行SHOW TABLES;正常情况下能看到 pet 商品表、user 用户表、orders 订单表、order_item 订单明细表以及存放宠物分类的 category 表。导入过程如果报错最常见的两类一是脚本第一行带着 DROP DATABASE 或 CREATE DATABASE而你当前用户权限不足——解决方法是把两行删掉自己先建好库再导入二是脚本用了ENGINEMyISAM虽然能建表但不支持外键和事务SSM 的事务管理形同虚设建议在导入后批量转成 InnoDB。转换语句如下ALTER TABLE pet_shop.pet ENGINE InnoDB; ALTER TABLE pet_shop.orders ENGINE InnoDB;每个表都执行一次略麻烦所以“网上宠物店”这类项目能不能用事务保护订单流程关键就在这。Spring 的 Transactional 注解只对 InnoDB 有效MyISAM 下就算代码写对了也拦不住半截订单。3.2 用 IDEA 导入并配置 Tomcat一次说清如果你用的是 IntelliJ IDEA导入老 Eclipse 工程时要选 “Import Project”然后在对话框里选 Eclipse 而不是 Maven。导入之后好多人直接点运行结果发现没有 Tomcat 配置这是正常的。你需要先确认项目结构里有没有部署描述符 web.xmlIDEA 里打开 Project Structure把 Web 模块的 Web Resource Directory 指到 WebRoot然后给 Artifacts 加上 exploded war 包。之后配置 Tomcat 的方式比较统一Run - Edit Configurations - 左上角加号选 Tomcat Server - Local。Application server 下拉框选你本机的 Tomcat 版本。Deployment 标签页添加 Artifact选择带 exploded 字样的那个。Server 标签页里把 HTTP port 设为 8080勾选 After launch 打开浏览器。启动时如果你碰上 404别先急着怀疑代码。打开 Tomcat 控制台看它实际部署的应用上下文路径是什么。老项目的 context 往往配成/pet_shop而不是/所以访问地址得是http://localhost:8080/pet_shop/login.jsp而不是直接敲 localhost:8080。这个细节在答辩现场翻车率极高你记住一条规则启动成功后先去 Tomcat 的 webapps 目录下看生成的文件夹名字那就是访问根路径。3.3 用 Maven 启动适合没有 IDE 的服务器环境如果你的 zip 包是 Maven 结构那就不用配 Tomcat 了可以用 tomcat7 插件直接跑。在 pom.xml 的 plugins 节点下加一段plugin groupIdorg.apache.tomcat.maven/groupId artifactIdtomcat7-maven-plugin/artifactId version2.2/version configuration port8080/port path/pet_shop/path uriEncodingUTF-8/uriEncoding /configuration /plugin然后在终端执行mvn clean tomcat7:run这里有两个参数要解释。port 决定监听端口如果 8080 被占用改成 8081path 是访问上下文路径必须和你的页面里写的 jsp 路径前缀一致否则跳转会 404。uriEncoding 设置成 UTF-8 是血泪经验不写这一行你从登录表单提交的中文用户名会在后端变成乱码。启动日志里看到 “Starting ProtocolHandler” 或 “Tomcat started” 字样说明服务器起来了。按下 CtrlC 停止不要直接把终端窗口关掉不然端口有时释放不干净。3.4 注册一个账号走通全流程验证表结构项目能打开首页不算跑通真正跑通的定义是从注册、登录、加购物车、提交订单到后台看到新订单全链路无报错。这一步不能只靠肉眼每个动作背后都对应着数据库里的一条记录变化。我一般会打开两个窗口左边是浏览器右边是 MySQL 命令行。注册完一个账号立刻去查用户表下单后立刻去查订单表。如果页面提示成功但表里没有数据八成是事务提交失败回滚了或者 MyBatis 的 insert 语句主键返回配置有问题。这里给一条常用查询语句方便你确认数据写没写进去SELECT id, username, phone, reg_time FROM pet_shop.user ORDER BY reg_time DESC LIMIT 3; SELECT o.id, o.order_no, o.total_price, o.create_time, o.status FROM pet_shop.orders o ORDER BY o.create_time DESC LIMIT 3;顺带一提最新网络热词里有一条“mysql排序”实际对应的就是这类ORDER BY ... DESC的写法。如果你的管理员页面能看到订单按时间倒序排列说明 SQL 的排序逻辑没问题如果顺序是乱的去 Mapper.xml 里查 resultMap 是否映射错了列。4. 避坑清单SSM 老项目跑不动的五个高频故障4.1 一启动就报 java.lang.ClassNotFoundException: org.springframework.web.servlet.DispatcherServlet现象是 Tomcat 启动直接失败控制台打出这个类找不到。原因往往是 jar 包没放进 WEB-INF/lib。Eclipse 老项目的 lib 目录虽然存在但没有自动打进部署包。IDEA 里打开 Project Structure - Artifacts看输出目录的 WEB-INF/lib 下是否真的有一堆 jar。如果没有把 lib 目录添加为 “Directory” 类型的 resource。解决逻辑DispatcherServlet 是 SpringMVC 的前端控制器它依赖的 jar 必须在运行时可见。手动把 lib 复制到 WEB-INF 是最快方案但如果你用的是 Maven就不要手动拷了检查 pom 里有没有 spring-webmvc 依赖执行mvn dependency:copy-dependencies重新生成 lib。4.2 Tomcat 10 下 JSP 全报 500提示 jakarta.servlet 包不存在现象是项目在 Tomcat 9 正常换到 Tomcat 10 之后所有 JSP 页面一访问就 500日志里一片 NoClassDefFoundError报的是 jakarta.servlet 相关类。原因Tomcat 10 把 javax.servlet 换成了 jakarta.servlet 命名空间老项目里的所有 servlet-api、jsp-api 依赖还写着 javax。这不是改代码能救的需要替换一整套依赖。解决这类 097 老毕设项目直接用 Tomcat 8.5 或 Tomcat 9.0别用 Tomcat 10。我一般会固定用 Tomcat 8.5.x兼容性好Spring 4.x 时代的老 SSM 项目在上面跑没有任何问题。4.3 MySQL 8 连接报 Public Key Retrieval is not allowed现象是项目启动后第一次访问数据库操作时报错日志里有关键词 Public Key Retrieval。原因MySQL 8 默认的 caching_sha2_password 认证插件要求客户端先获取 RSA 公钥而老版本的 mysql-connector-java 不支持这个流程。你的 jar 包很可能是 5.1.x甚至更老。解决两个可以同时做的事。第一把 jdbc.url 加上两个参数jdbc:mysql://localhost:3306/pet_shop?useSSLfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai第二把 mysql-connector-java 的 jar 替换成 8.0.x 以上版本。如果项目是 Maven 的在 pom.xml 里改版本号dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.29/version /dependency如果项目是 lib 拷包方式去本地 Maven 仓库找个 8.0 的 jar或者直接下载对应的独立 jar 覆盖旧的删除旧 jar 再引入新的。4.4 注册账号输入中文变问号或乱码现象是前端输入“张三”数据库存成了“???”或者页面回显乱码。原因链路里任何一环的字符集没对齐都会乱。常见的原因有三个MySQL 表字段不是 utf8mb4、JSP 页面没有指定 pageEncoding、IDEA 里 Tomcat 启动 VM 参数没加文件编码。三者缺一不可。解决一层层查。先查 JSP 页面第一行有没有% page languagejava contentTypetext/html; charsetUTF-8 pageEncodingUTF-8 %再查数据库表结构SHOW CREATE TABLE user; /* 看 DEFAULT CHARSET 是不是 utf8mb4如果不是执行下面这句 */ ALTER TABLE user CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;最后在 IDEA 的 Tomcat 配置里把 VM options 加上-Dfile.encodingUTF-8。注意三个位置全做不要只改一个。4.5 商品图片不显示路径 404现象是列表页里的图片全是裂图检查 target 目录发现 upload 或 images 目录是空的。原因这类网上宠物店项目的图片要么存在本地磁盘指定目录要么存在项目 webapp 某个文件夹下。本地磁盘方式需要配置虚拟路径映射很多同学没配所以找不到。解决到底哪种方式看 tomcat 的 web.xml 或 spring-mvc.xml 里有没有 resource 映射配置。如果是 SpringMVC 的静态资源映射配置是这样mvc:resources location/static/upload/ mapping/upload/** /这里 mapping 是浏览器访问的 URL 前缀location 是项目内的物理目录。如果图片存在了磁盘路径比如D:/pet_shop/img那么需要配置 Tomcat 虚拟路径。5. 从会跑到会改二次开发必懂的三个改造点5.1 给所有后台页面加权限校验用拦截器而不是每个 JSP 判断网上宠物店项目普遍有个 bug后台管理页面没有做权限拦截用户直接输入 URL 就能进管理员页面。毕业答辩时老师最爱干的事就是在地址栏敲 admin 相关路径如果直接跳进去你这部分的分数就悬了。改造思路是在 SpringMVC 里注册一个拦截器。先在 java 包下新建 LoginInterceptor 类public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object adminUser request.getSession().getAttribute(adminUser); if (adminUser null) { // 未登录跳转回登录页 response.sendRedirect(request.getContextPath() /admin/login.jsp); return false; } return true; // 已登录放行 } }逻辑说明preHandle 在控制器方法执行前触发从 Session 里取管理员对象。如果为 null就强制跳回登录页。return false 表示中断本次请求后面的 Controller 不会执行。然后在 spring-mvc.xml 里注册拦截器并配置路径mvc:interceptors mvc:interceptor mvc:mapping path/admin/** / mvc:exclude-mapping path/admin/login.jsp / mvc:exclude-mapping path/admin/login / bean classcom.pet.interceptor.LoginInterceptor / /mvc:interceptor /mvc:interceptors这里最关键的是 exclude-mapping必须把登录页面和相关 Controller 排除掉否则会陷入“访问登录页提示需要登录”的死循环。路径写错了你就能亲身体验什么叫死循环玄学。5.2 购物车用 Session 存储千万别放数据库购物车是网上宠物店的演示核心但很多老项目直接把购物车数据存到数据库表。数据量大时这样做没问题但毕设演示场景完全没必要。把购物车放到 Session 里的理由是购物车本来就是临时数据用户在演示时可能加了删、删了加如果用数据库表每次操作都要刷新购物车表代码量大还容易在反复操作时闹出外键约束的问题。改造思路是在 Controller 里用HttpSession保存一个MapInteger, Integerkey 是宠物商品 idvalue 是数量。加入购物车时这样写MapInteger, Integer cart (MapInteger, Integer) session.getAttribute(cart); if (cart null) { cart new HashMap(); } // petId 由前端传入num 默认 1如果已存在则累加 cart.put(petId, cart.getOrDefault(petId, 0) num); session.setAttribute(cart, cart);逻辑说明getAttribute 取出购物车如果为空则新建。第二次加同一件商品时getOrDefault 把数量取出来加一再放回去。缺点是刷新页面后购物车会消失重启浏览器也没了但这就是 Session 的特性适用于毕设演示。5.3 订单表加一个 status 状态字段让流程完整展示老项目里订单表可能只有下单时间没有状态字段用户下单后不知道订单处于什么阶段。答辩时老师要看的往往不是页面多华丽是业务流程是否完整。给订单表加字段是最低成本的改造。先在数据库里加字段ALTER TABLE pet_shop.orders ADD COLUMN status TINYINT NOT NULL DEFAULT 0 COMMENT 0-待付款 1-已付款 2-已发货 3-已完成 4-已取消;然后在 JSP 订单列表中显示状态时不要直接输出数字写一个小方法映射成中文。常见做法是在实体类里加一个 getStatusDesc 方法public String getStatusDesc() { switch (this.status) { case 0: return 待付款; case 1: return 已付款; case 2: return 已发货; case 3: return 已完成; case 4: return 已取消; default: return 未知状态; } }这段代码不涉及 SQL但你要在列表 JSP 里这样调用${order.statusDesc}。同时记得把 MyBatis 的 resultMap 里映射 status 字段否则实体类里的 status 永远是 null状态显示不出来。很多同学改完数据库后台发现状态不显示就是漏了这步。6. 用 MyBatis 日志把“看不见的 SQL”揪出来一个提高调试效率的习惯项目改到一定程度你会遇到一种局面页面报错 500但控制台只打印了一行异常没有具体的 SQL 信息你完全不知道执行到哪一步挂的。老 SSM 项目里MyBatis 默认不打印执行日志连参数都看不到排查问题全靠猜。我不止一次在这种猜的过程中浪费过一下午后来养成了先开 SQL 日志再看业务代码的习惯效率翻倍。做法是在 mybatis-config.xml 的 settings 节点加一行settings setting namelogImpl valueSTDOUT_LOGGING / /settings加了这行配置之后重启 Tomcat再触发一次下单操作控制台就会把每条 SQL 打出来包括预处理参数。比如你会看到类似这样的输出 Preparing: INSERT INTO orders (user_id, order_no, total_price, status, create_time) VALUES (?, ?, ?, ?, ?) Parameters: 1(Long), 20250315001(String), 99.0(Double), 0(Integer), 2025-03-15 14:23:11(Timestamp) Updates: 1怎么看这个输出关键在 Preparing 那行的 SQL 和后面 Parameters 的每个参数顺序对应关系。如果参数个数对不上说明占位符和实体类字段映射错位了如果 Updates 显示 1说明插入成功那订单表里查不到数据就是事务提交或回滚的问题。还有注意如果最后显示 Updates: 0但页面提示成功了多半是 Controller 没调 mapper 的 insert 方法或者调用的是另一个空方法。日志不会骗人。这个习惯坚持下来你会发现绝大多数 SSM 项目的问题根本不需要看业务代码逐行猜看 SQL 日志第一眼就能定位到 Mapper.xml。处理完订单之后我还会顺手把 logImpl 改成 Log4j 并配置一个 FileAppender把 SQL 输出到文件里因为控制台日志最多留几千行不够查历史记录。但如果你只是答辩前调试STDOUT_LOGGING 写到控制台已经足够。最后提醒你一句网上宠物店这种项目技术栈不算新但它的结构、分层和字段设计仍旧是理解 Java Web 开发的好样本。你下载 zip 后先别急着改需求按原文这套流程把它跑起来再按照自己的业务方向去改页面、改字段这比从零写一个系统省下的时间足够你把 SSM 每层吃透。希望这个方案能帮你在毕业设计这一关平稳落地。本文还有配套的精品资源点击获取
原理与用法详解)
