简介：这是一套面向高校计算机专业毕业设计的完整项目资料，主题为Java微信小程序宠物店商城系统，采用SSM框架搭建后台、Vue构建管理页面、微信小程序作为用户端，数据库使用MySQL，兼容JDK1.8及Eclipse、IDEA等主流开发工具。系统围绕宠物信息管理与商品销售展开，区分管理员、商家、用户三类角色，涵盖宠物分类、宠物用品、服务项目、订单、日志等管理模块，并支持购买宠物、预约服务等业务流程。资源包共1662个文件，约52.19MB，包含184个Java源码、177个Vue组件、250个JS脚本、132个WXSS与130个WXML小程序页面文件，以及PNG、SVG等界面素材和SQL脚本，另附论文、数据库脚本、环境工具包与同框架项目安装教程。已有123人学习，适合需要完整赛题方案、源码参考与部署排错思路的毕业生直接借鉴。
1. 从一份“宠物店商城小程序”标题里，拆出真正能跑通的 SSM 落地路径
如果你正在搜“毕业设计java微信小程序宠物店商城小程序设计与实现+ssm源码含文档含教程”，大概率不是想听概念，而是想确认三件事：这套东西到底由哪些模块组成、SSM 后端和微信小程序前端怎么对接、拿到源码后怎么在自己机器上跑起来。我做过几套类似结构的商城类毕设，宠物店这个题材的特殊点在于商品 SKU 少但服务类目多（洗澡、寄养、驱虫），订单状态比普通商城更绕，所以它比“纯卖货”的商城更能体现设计工作量。
这篇笔记按“先立住结构，再动手复现”的顺序写。适合两类人：一是要交毕业设计、需要能演示能答辩的同学；二是想用一套完整前后端分离案例练手 SSM + 小程序联调的开发者。我不会假设你手里已经有一份完美源码，而是把这类项目最常见的目录结构、接口约定、参数配置和翻车点讲清楚，你照着就能判断手里的代码缺什么、该补哪里。
2. 宠物店商城的模块边界：先想清楚哪些表必须建
2.1 为什么宠物店商城不能照抄普通商城表结构
普通商城的核心是“商品—购物车—订单”，宠物店如果只做这个，答辩时老师一句“你这和卖衣服有什么区别”就够呛。宠物店真正的业务增量在服务预约：洗澡、美容、寄养这些不是标准商品，它们有“时间段”“宠物信息”“服务人员”三个额外维度。所以表设计上，除了常规的商品表、订单表，必须多出pet（宠物档案）、service_item（服务项目）、appointment（预约单）三张核心表。
我一般会这样划分模块：用户端（微信小程序）负责浏览、下单、预约、查看订单；管理端（SSM 后台）负责商品上下架、订单处理、预约排期、会员管理。两端共用同一套 Service 层，Controller 分/api/wx/和/api/admin/两个前缀。这样做的理由是：小程序端不需要登录后台账号，用 openid 换 token 即可；后台走传统的账号密码 session。两套鉴权逻辑分开，后期加权限不会互相污染。
提示：如果你的源码里
appointment表和order表是合并的，建议拆开。预约有时段冲突校验，订单没有，混在一起后面加排期逻辑会非常痛苦。
2.2 核心表清单与字段取舍
下面这张表是我在多个同类项目里收敛出来的最小可用集合，字段只列关键项，具体长度按 MySQL 8 的规范来：
| 表名 | 关键字段 | 说明 |
|---|---|---|
user | id, openid, nickname, phone, member_level | openid 唯一索引，会员等级用于折扣 |
pet | id, user_id, pet_name, pet_type, age, note | 一个用户可有多只宠物 |
category | id, name, sort, status | 商品分类，status 控制是否展示 |
product | id, category_id, name, price, stock, cover, detail | 普通商品 |
service_item | id, name, price, duration, max_per_slot | 服务项目，duration 单位分钟 |
appointment | id, user_id, pet_id, service_id, appoint_time, status | status 走 0待确认/1已确认/2已完成/3已取消 |
orders | id, order_no, user_id, total_amount, pay_status, order_status | order_no 用时间戳+随机数 |
order_item | id, order_id, product_id, count, price | 下单时价格快照，防止商品改价影响历史单 |
这里有个血泪经验：order_item里的price一定要存下单那一刻的价格，不要关联查product.price。我见过有人图省事直接 join，结果商品调价后所有历史订单金额全变了，答辩现场被问得下不来台。
2.3 从表结构反推接口清单
表定完，接口基本就定了。小程序端需要的接口大致是：/api/wx/login（code 换 openid）、/api/wx/product/list、/api/wx/product/detail、/api/wx/cart/add、/api/wx/order/create、/api/wx/appointment/create、/api/wx/appointment/list。后台端是：/api/admin/product/save、/api/admin/order/list、/api/admin/appointment/confirm。
判断一份源码是否完整，最快的办法就是数 Controller 里的方法数。一个能演示的宠物店商城，小程序端接口不应少于 15 个，后台端不应少于 20 个。如果只有个位数，那大概率是个半成品，文档和教程也补不回来。
3. SSM 后端怎么搭：从 pom 到第一个能返回 JSON 的接口
3.1 依赖版本与目录结构
SSM 指的是 Spring + SpringMVC + MyBatis。虽然现在新项目多用 SpringBoot，但毕业设计里 SSM 依然是主流，因为分层清晰、答辩好讲。我一般用这套版本组合：Spring 5.3.x、MyBatis 3.5.x、Druid 1.2.x、MySQL 8.0 驱动、Jackson 2.13.x。JDK 用 8 或 11 都行，别用 17，部分老教程的 jar 包会出兼容问题。
标准目录结构是这样的：
src/main/java/com/pet ├── controller // 分 wx 和 admin 两个包 ├── service │ └── impl ├── mapper // MyBatis 接口 ├── entity // 与表对应 ├── dto // 接收前端参数 ├── vo // 返回给前端 └── util // 统一返回、token 工具 src/main/resources ├── mapper // XML 映射文件 ├── spring-dao.xml ├── spring-service.xml ├── spring-mvc.xml └── jdbc.propertiesjdbc.properties里至少要配jdbc.url、jdbc.username、jdbc.password、jdbc.driver。注意 MySQL 8 的 URL 必须带时区和useSSL=false，否则启动就报时区错误：
jdbc.driver=com.mysql.cj.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/pet_shop?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false jdbc.username=root jdbc.password=你的密码参数说明：serverTimezone不写会报The server time zone value is unrecognized；useSSL=false是本地开发省去证书配置，生产环境要另说。
3.2 统一返回结构：别让前端猜你的字段
小程序端最怕后端返回格式不统一，一会儿{code:0}一会儿{success:true}。我一般定一个Result类，所有接口都返回它：
public class Result<T> { private Integer code; // 200 成功，500 失败，401 未登录 private String msg; private T data; public static <T> Result<T> ok(T data) { Result<T> r = new Result<>(); r.setCode(200); r.setMsg("success"); r.setData(data); return r; } public static <T> Result<T> fail(String msg) { Result<T> r = new Result<>(); r.setCode(500); r.setMsg(msg); return r; } }逻辑说明：code用 HTTP 语义的数字，前端拦截器里判断code === 401就跳登录页，code === 200才取data。这样前端不用为每个接口写不同的判断。参数上data用泛型，返回列表就是Result<List<Product>>，返回单个对象就是Result<Product>。
3.3 一个完整的商品列表接口
以/api/wx/product/list为例，Controller 长这样：
@RestController @RequestMapping("/api/wx/product") public class WxProductController { @Autowired private ProductService productService; @GetMapping("/list") public Result<List<Product>> list(@RequestParam(required = false) Integer categoryId, @RequestParam(defaultValue = "1") Integer page, @RequestParam(defaultValue = "10") Integer size) { // 分页参数做一次保护，防止前端传 0 或负数 if (page < 1) page = 1; if (size > 50) size = 50; List<Product> list = productService.listByCategory(categoryId, (page - 1) * size, size); return Result.ok(list); } }逻辑说明：categoryId可为空，为空就查全部；page和size给了默认值并做了上限保护，防止有人传size=10000把数据库拖垮。Service 层对应的方法在 XML 里用limit #{offset}, #{size}实现分页。参数上offset是(page-1)*size，这是 MySQL 分页的标准写法。
注意：如果你的源码里分页用的是 PageHelper，那要确认
pom.xml里引入了pagehelper依赖，并且在spring-dao.xml里配置了拦截器，否则分页不生效但也不报错，查出来永远是全量数据。
3.4 跨域与静态资源映射
小程序开发时，微信开发者工具请求本地后端会遇到跨域。SSM 里最简单的处理是在spring-mvc.xml加：
<mvc:cors> <mvc:mapping path="/api/**" allowed-origins="*" allowed-methods="GET,POST,PUT,DELETE" allowed-headers="*" allow-credentials="true"/> </mvc:cors>参数说明：allowed-origins开发期用*，上线后要改成具体域名；allow-credentials为 true 时allowed-origins不能是*，这是浏览器的限制，本地调试如果遇到 cookie 带不上，先检查这一条。另外图片上传后要能访问，需要在spring-mvc.xml里加<mvc:resources mapping="/upload/**" location="file:D:/upload/"/>，路径按你实际存储位置改。
4. 微信小程序端怎么接：登录、请求封装与预约时段选择
4.1 登录流程：code 换 openid 再换 token
小程序的登录不能直接拿用户信息，标准流程是：wx.login()拿到 code，传给后端，后端用 code + appid + secret 调微信接口换 openid，再生成自己的 token 返回。后端这部分代码：
@PostMapping("/login") public Result<String> login(@RequestBody LoginDTO dto) { // dto.getCode() 是小程序 wx.login 拿到的 String url = "https://api.weixin.qq.com/sns/jscode2session?appid=" + appid + "&secret=" + secret + "&js_code=" + dto.getCode() + "&grant_type=authorization_code"; String resp = restTemplate.getForObject(url, String.class); JSONObject json = JSON.parseObject(resp); String openid = json.getString("openid"); if (openid == null) { return Result.fail("登录失败"); } // 查库，没有就注册 User user = userService.findOrCreateByOpenid(openid); String token = JwtUtil.sign(user.getId()); return Result.ok(token); }逻辑说明：appid和secret放在配置文件里，不要硬编码在 Java 里。findOrCreateByOpenid做的是“查不到就插入”，保证第一次登录自动注册。token 用 JWT 或简单的 UUID 存 Redis 都行，毕设用 JWT 更省事，不用额外装 Redis。
4.2 请求封装：一次封装，全局带 token
小程序端我一般建一个request.js：
const BASE_URL = 'http://localhost:8080'; function request(options) { return new Promise((resolve, reject) => { wx.request({ url: BASE_URL + options.url, method: options.method || 'GET', data: options.data || {}, header: { 'content-type': 'application/json', 'token': wx.getStorageSync('token') || '' }, success(res) { if (res.data.code === 200) { resolve(res.data.data); } else if (res.data.code === 401) { wx.removeStorageSync('token'); wx.navigateTo({ url: '/pages/login/login' }); reject(res.data.msg); } else { wx.showToast({ title: res.data.msg, icon: 'none' }); reject(res.data.msg); } }, fail(err) { wx.showToast({ title: '网络异常', icon: 'none' }); reject(err); } }); }); } module.exports = { request };逻辑说明：header里统一带 token，后端拦截器从 header 取 token 校验。code === 401时清 token 并跳登录，这是全局兜底。参数上BASE_URL在开发时是本地 IP，真机调试要改成电脑局域网 IP，不能用localhost，这是新手最常翻车的地方。
4.3 预约时段选择：宠物店特有的交互
服务预约和买商品不同，用户要选日期和时段。我一般把时段做成固定几档：10:00-12:00、14:00-16:00、16:00-18:00。前端用 picker 选日期，用 radio 选时段。提交前先调一个/api/wx/appointment/check接口查该时段是否已满：
async submitAppointment() { const res = await request({ url: '/api/wx/appointment/check', method: 'POST', data: { serviceId: this.data.serviceId, appointTime: this.data.date + ' ' + this.data.slot } }); if (!res.available) { wx.showToast({ title: '该时段已约满', icon: 'none' }); return; } await request({ url: '/api/wx/appointment/create', method: 'POST', data: {...} }); wx.showToast({ title: '预约成功' }); }逻辑说明：check接口在后端统计该时段已有预约数，和service_item.max_per_slot比较。参数上appointTime用yyyy-MM-dd HH:mm格式，后端用@JsonFormat解析。这个“先查再提交”的模式有个并发漏洞，两个人同时查都显示可约，所以后端create里还要再校验一次，前端校验只是提升体验。
5. 避坑与排查：这类毕设最容易翻车的 5 个地方
5.1 小程序请求本地后端报“不在以下 request 合法域名列表中”
现象：开发者工具里勾了“不校验合法域名”能跑，真机预览就失败。原因：真机不走开发者工具的忽略校验。解决：要么在微信公众平台配置合法域名（需要备案域名），要么真机调试时在手机端开启调试模式。毕设演示一般用开发者工具投屏，问题不大，但答辩前一定要确认演示环境。
5.2 图片上传后小程序显示 404
现象：后台上传成功，数据库也有路径，但小程序<image>不显示。原因：多半是spring-mvc.xml里没配<mvc:resources>，或者路径映射写错。解决：确认location指向的物理路径真实存在，且mapping和数据库存的 URL 前缀一致。我一般数据库存/upload/xxx.jpg，映射配/upload/**。
5.3 订单金额和商品总价对不上
现象：购物车结算金额比实际商品总价多几分钱。原因：用了double做金额计算，浮点误差累积。解决：金额字段用BigDecimal，数据库用decimal(10,2)，Java 里new BigDecimal("19.9")而不是new BigDecimal(19.9)。这个坑在答辩时如果被问到，能答上来是加分项。
5.4 MyBatis 查询返回 null 但数据库有数据
现象：接口返回data: null，日志里 SQL 也执行了。原因：实体类字段名和数据库列名不一致，且没配resultMap或mapUnderscoreToCamelCase。解决：在mybatis-config.xml里加<setting name="mapUnderscoreToCamelCase" value="true"/>，让pet_name自动映射到petName。如果还不行，检查是不是用了@Param但 XML 里没对应。
5.5 后台管理页面登录后刷新就退出
现象：登录成功，点一下菜单就跳回登录页。原因：session 跨域或 cookie 没带上。解决：确认前端请求带了withCredentials，后端 CORS 配了allow-credentials="true"，且allowed-origins不是*。如果是前后端分离部署，建议直接用 token 替代 session，省去这些麻烦。
6. 让这套毕设从“能跑”到“能讲”：接口文档与演示脚本
最后一章说点实在的。很多人代码跑通了，但答辩讲不清楚，问题出在没有把“设计”和“实现”串起来。我的习惯是：在项目根目录放一个api.md，把每个接口的 URL、方法、参数、返回示例列成表。这份文档不用多漂亮，但答辩时老师翻到会觉得你思路清晰。
再准备一个演示脚本，按这个顺序走一遍：小程序登录 → 浏览商品 → 加入购物车 → 下单 → 查看订单 → 预约洗澡 → 后台确认预约 → 后台发货。全程控制在 3 分钟内，中间不要现场调试。我见过太多人现场改代码改到超时，血泪经验就是：演示前把数据准备好，订单和预约各留一条待处理状态，别现场造数据。
如果你手里的源码缺文档，别急着找“完整版”，先按第 2 章的表清单对一遍，缺哪张表补哪张，缺哪个接口补哪个。SSM 这套东西结构是死的，补起来比想象中快。真正值不值得投入，取决于你愿不愿意把预约这条业务线做扎实——它才是宠物店商城区别于普通商城的地方，也是答辩时最能讲出设计含量的部分。
我自己的习惯是每做完一个模块就写三行注释：这个模块解决什么问题、关键参数是什么、哪里容易出错。攒到最后，文档自然就有了。希望帮到你。
本文还有配套的精品资源，点击获取
