简介：采用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，后端 SSM（Spring + 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 映射。整条请求链是：浏览器请求到 DispatcherServlet（SpringMVC）→ Controller 调 Service → Service 调 Mapper（MyBatis）→ 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 项目叫 WebRoot，Maven 结构叫 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.properties：
jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/pet_shop?useUnicode=true&characterEncoding=utf8 jdbc.username=root jdbc.password=123456这里最值得你关注的是 driver 和 url。很多老项目拿到 MySQL 8 上跑，第一行还写着com.mysql.jdbc.Driver，这个类在 MySQL 8 的驱动包里已经被移除了，必须换成com.mysql.cj.jdbc.Driver。同时 MySQL 8 对时区很敏感，建议把 url 改成jdbc:mysql://localhost:3306/pet_shop?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai。password 用你自己本机的 MySQL 密码替换，这个文件改完，数据库连接才有救。
第二个是spring-mvc.xml里的视图解析器：
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/jsp/" /> <property name="suffix" 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 id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"> <property name="driverClass" value="${jdbc.driver}" /> <property name="jdbcUrl" value="${jdbc.url}" /> <property name="user" value="${jdbc.username}" /> <property name="password" value="${jdbc.password}" /> <property name="initialPoolSize" value="5" /> </bean>如果你对这个配置不熟，最容易踩的坑是把 driverClass 写成 driver，c3p0 会直接报属性找不到，连带 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，而你当前用户权限不足——解决方法是把两行删掉，自己先建好库再导入；二是脚本用了ENGINE=MyISAM，虽然能建表但不支持外键和事务，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.xml，IDEA 里打开 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> <groupId>org.apache.tomcat.maven</groupId> <artifactId>tomcat7-maven-plugin</artifactId> <version>2.2</version> <configuration> <port>8080</port> <path>/pet_shop</path> <uriEncoding>UTF-8</uriEncoding> </configuration> </plugin>然后在终端执行：
mvn clean tomcat7:run这里有两个参数要解释。port 决定监听端口，如果 8080 被占用改成 8081；path 是访问上下文路径，必须和你的页面里写的 jsp 路径前缀一致，否则跳转会 404。uriEncoding 设置成 UTF-8 是血泪经验，不写这一行，你从登录表单提交的中文用户名会在后端变成乱码。
启动日志里看到 “Starting ProtocolHandler” 或 “Tomcat started” 字样，说明服务器起来了。按下 Ctrl+C 停止，不要直接把终端窗口关掉，不然端口有时释放不干净。
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?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai第二，把 mysql-connector-java 的 jar 替换成 8.0.x 以上版本。如果项目是 Maven 的，在 pom.xml 里改版本号：
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.29</version> </dependency>如果项目是 lib 拷包方式，去本地 Maven 仓库找个 8.0 的 jar，或者直接下载对应的独立 jar 覆盖旧的，删除旧 jar 再引入新的。
4.4 注册账号输入中文变问号或乱码
现象是前端输入“张三”，数据库存成了“???”，或者页面回显乱码。
原因：链路里任何一环的字符集没对齐，都会乱。常见的原因有三个：MySQL 表字段不是 utf8mb4、JSP 页面没有指定 pageEncoding、IDEA 里 Tomcat 启动 VM 参数没加文件编码。三者缺一不可。
解决：一层层查。先查 JSP 页面第一行有没有：
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-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.encoding=UTF-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 class="com.pet.interceptor.LoginInterceptor" /> </mvc:interceptor> </mvc:interceptors>这里最关键的是 exclude-mapping，必须把登录页面和相关 Controller 排除掉，否则会陷入“访问登录页提示需要登录”的死循环。路径写错了，你就能亲身体验什么叫死循环玄学。
5.2 购物车用 Session 存储千万别放数据库
购物车是网上宠物店的演示核心，但很多老项目直接把购物车数据存到数据库表。
数据量大时这样做没问题，但毕设演示场景完全没必要。把购物车放到 Session 里的理由是：购物车本来就是临时数据，用户在演示时可能加了删、删了加，如果用数据库表，每次操作都要刷新购物车表，代码量大，还容易在反复操作时闹出外键约束的问题。
改造思路是在 Controller 里用HttpSession保存一个Map<Integer, Integer>，key 是宠物商品 id，value 是数量。加入购物车时这样写：
Map<Integer, Integer> cart = (Map<Integer, 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 name="logImpl" value="STDOUT_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 每层吃透。希望这个方案能帮你在毕业设计这一关平稳落地。
本文还有配套的精品资源，点击获取
