SSM+微信小程序宠物寄养平台毕设：从零搭建到避坑指南-育师

简介：这是一套基于Java与SSM框架、结合微信小程序前端开发的宠物寄养平台毕业设计资源，面向需要完成高分毕设或课程设计的学生。项目围绕宠物主人、寄养者与管理员三类角色，实现寄养信息发布、宠物浏览、预约服务、用户管理与消息通知等完整业务流程，前后端代码齐备，可直接部署运行。压缩包共1206个文件，约47.16MB，包含96个Java后端源码、123个Vue组件、160个JS脚本、70个WXML与72个WXSS小程序页面样式，以及2个SQL数据库脚本、论文文档和Maven构建配置，覆盖源码、数据库与开发工具。已有49人学习下载。资源提供完整可运行的工程结构、数据库表设计与初始化脚本，并附论文文档，便于理解SSM分层架构、前后端分离模式与微信小程序开发流程，适合作为毕设参考与实践平台。

1. 宠物寄养平台为什么值得用 SSM + 微信小程序做毕设

宠物寄养这个场景，表面看是"帮人看几天猫狗"，落到系统里其实是一套典型的双边预约交易流程：宠物主发布寄养需求、寄养家庭接单、平台撮合、订单状态流转、评价沉淀。它比外卖、电商简单，但比增删改查的通讯录复杂得多，正好卡在毕设"能讲清楚业务、又能体现技术栈"的甜区上。用 Java + SSM + MySQL 做后端、微信小程序做前端，是这几年高校毕设里最稳的组合之一：SSM 三层结构清晰，答辩时老师问得出来你答得上来；小程序免安装、能扫码演示，答辩现场掏出手机就能跑。这篇笔记就按"这是什么 → 怎么搭 → 坑在哪 → 怎么做得更扎实"的顺序，把一套能复现的宠物寄养平台从零讲透，适合正在选毕设题、或者已经拿到一份 SSM 小程序源码但不知道怎么跑起来的同学。

2. 技术选型与整体架构：SSM 三层怎么和小程序对接

2.1 为什么是 SSM 而不是 Spring Boot

很多同学一上来就问：现在都 Spring Boot 了，为什么毕设还在用 SSM？答案很现实——SSM（Spring + SpringMVC + MyBatis）是"看得见骨架"的框架。Spring 管 Bean 和事务，SpringMVC 管请求分发，MyBatis 管 SQL 映射，三层职责分明，答辩时你能指着配置文件说清楚每个 XML 在干什么。Spring Boot 把这一切自动装配了，反而让基础不牢的同学讲不出所以然。

具体到宠物寄养平台，SSM 的落地方式是：

Controller 层：接收小程序发来的 HTTP 请求，比如/order/create、/pet/list，做参数校验后调用 Service。
Service 层：写业务逻辑，比如"下单前先检查该寄养家庭当天是否已满员"，事务注解@Transactional加在这一层。
Mapper 层：MyBatis 的接口 + XML，负责和 MySQL 打交道，复杂查询（比如按距离、按评分筛选寄养家庭）写在这里。

小程序端不直接连数据库，它只认 HTTP 接口。所以后端要统一返回 JSON，通常封装一个Result类：

// 统一响应结构，code=200 表示成功 public class Result<T> { private Integer code; private String msg; private T data; // 省略 getter/setter，实际项目里用 Lombok 的 @Data 更省事 public static <T> Result<T> ok(T data) { Result<T> r = new Result<>(); r.code = 200; r.msg = "success"; r.data = data; return r; } public static <T> Result<T> fail(String msg) { Result<T> r = new Result<>(); r.code = 500; r.msg = msg; return r; } }

这段代码看着简单，但它是前后端契约的核心。小程序里wx.request拿到响应后，先判断res.data.code === 200再取res.data.data，这个约定一旦定下来，后面所有接口都照此办理，不会乱。

2.2 小程序端和后端的对接方式

小程序用原生开发还是 uniapp？如果标题里明确是"微信小程序"，我一般建议原生，因为毕设答辩时老师可能让你现场改个页面，原生 WXML/WXSS 改起来直观。对接后端就三步：

在app.js里配一个全局的baseUrl，比如http://localhost:8080/pet。
封装一个request.js，统一处理 header、token、错误提示。
每个页面调用封装好的方法，不直接写wx.request。

// utils/request.js const BASE_URL = 'http://localhost:8080/pet'; function request(url, method = 'GET', data = {}) { return new Promise((resolve, reject) => { wx.request({ url: BASE_URL + url, method, data, header: { 'content-type': 'application/json' }, success: (res) => { if (res.data.code === 200) { resolve(res.data.data); } else { wx.showToast({ title: res.data.msg, icon: 'none' }); reject(res.data.msg); } }, fail: reject }); }); } module.exports = { request };

参数说明：BASE_URL在开发阶段指向本机，真机调试时要换成局域网 IP（比如http://192.168.1.100:8080/pet），否则手机访问不到 localhost。header里的content-type必须和 SpringMVC 的@RequestBody配合，不然会报 415 错误。这个封装把 token 校验、loading 提示都收口到一处，后面加登录态时只改这一个文件。

2.3 数据库表设计的最小集合

宠物寄养平台的核心表不多，但关系要理清。最少需要这几张：

表名	作用	关键字段
user	用户（宠物主/寄养家庭共用，用 role 区分）	id, openid, nickname, phone, role
pet	宠物信息	id, user_id, name, type, age, note
host	寄养家庭信息	id, user_id, address, price_per_day, capacity
orders	订单	id, user_id, host_id, pet_id, start_date, end_date, status
comment	评价	id, order_id, score, content

orders表的status字段是业务核心，建议用整数枚举：0 待接单、1 已接单、2 寄养中、3 已完成、4 已取消。用整数而不是字符串，查询和索引都更高效。user表用openid关联微信身份，这是小程序登录的关键，下一章细讲。

3. 从零跑通：环境搭建、数据库导入与后端启动

3.1 开发环境清单与版本选择

拿到一份 SSM 源码，第一步不是急着打开 IDE，而是先把环境对齐。版本不匹配是新手翻车最多的地方。我一般用这套组合：

JDK 1.8（SSM 项目对 JDK 8 兼容最好，别上 17，容易踩反射的坑）
Maven 3.6+
MySQL 5.7 或 8.0（8.0 要改驱动类和时区配置，见 3.3）
Tomcat 8.5 或 9.0
IDEA 或 Eclipse

MySQL 安装这块，Windows 上如果不想折腾，直接下 MSI 安装包一路下一步；想用免安装版（zip）的话，记得手动初始化：

# 解压后在 bin 目录执行，生成 data 目录和临时密码 mysqld --initialize-insecure --user=mysql # 注册服务 mysqld --install mysql # 启动 net start mysql

--initialize-insecure表示 root 无密码，方便本地开发，但生产环境千万别这么干。启动后如果报"服务正在启动"卡住，多半是my.ini里basedir和datadir路径写错了，或者 3306 端口被占用。

3.2 导入数据库脚本

源码包里通常有一个pet.sql，导入命令：

# 先建库（如果脚本里没写 CREATE DATABASE） mysql -u root -p -e "CREATE DATABASE pet DEFAULT CHARACTER SET utf8mb4;" # 导入 mysql -u root -p pet < pet.sql

注意字符集一定要用utf8mb4，不是utf8。宠物昵称里可能有 emoji，utf8存不进去会报错。导入后进 MySQL 检查一下：

USE pet; SHOW TABLES; SELECT COUNT(*) FROM user;

如果表是空的，说明脚本只建了结构没插数据，这很正常，毕设演示数据可以自己造几条。

3.3 后端配置文件的四个必改项

SSM 项目的配置文件集中在src/main/resources下，通常有jdbc.properties、applicationContext.xml、spring-mvc.xml。拿到手必须改这几处：

# jdbc.properties jdbc.driver=com.mysql.cj.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/pet?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false jdbc.username=root jdbc.password=你的密码

四个坑点：第一，MySQL 8.0 的驱动类是com.mysql.cj.jdbc.Driver，5.7 是com.mysql.jdbc.Driver，写错直接连不上；第二，serverTimezone必须加，否则报时区错误；第三，useSSL=false去掉警告；第四，characterEncoding=utf8配合数据库的 utf8mb4 使用。

改完配置，用 Maven 打包部署到 Tomcat：

mvn clean package -DskipTests # 把 target 下的 war 丢进 Tomcat 的 webapps，启动

访问http://localhost:8080/pet/user/list看能不能返回 JSON，能返回就说明后端通了。

3.4 小程序端启动与真机调试

小程序用微信开发者工具打开源码目录，先在project.config.json里确认appid。没有自己的 appid 就选"测试号"，但测试号不能真机预览，只能模拟器跑。要真机调试，得用自己注册的小程序 appid。

启动后如果页面空白，先看控制台报错。最常见的是request 合法域名校验失败，解决办法是在开发者工具右上角"详情 → 本地设置"里勾选"不校验合法域名"。这个选项只在开发阶段用，上线前必须在小程序后台配置服务器域名。

真机调试时，手机和电脑要在同一个 WiFi 下，BASE_URL换成电脑的局域网 IP。如果还是连不上，检查 Windows 防火墙有没有拦 8080 端口。

4. 微信登录与手机号获取：小程序身份体系怎么落地

4.1 登录流程的完整链路

微信小程序的登录不是简单的账号密码，而是一套code换openid的机制。流程是：

小程序调wx.login()拿到临时code。
把code发给后端。
后端用code+appid+secret调微信接口，换回openid和session_key。
后端根据openid查用户表，没有就新建，有就更新，然后生成自己的 token 返回给小程序。
小程序把 token 存到storage，后续请求带上。

// 小程序端登录 wx.login({ success: (res) => { if (res.code) { request('/wx/login', 'POST', { code: res.code }).then(user => { wx.setStorageSync('token', user.token); wx.setStorageSync('userId', user.id); }); } } });

后端换 openid 的代码：

// 用 RestTemplate 调微信接口 String url = "https://api.weixin.qq.com/sns/jscode2session?appid=" + appid + "&secret=" + secret + "&js_code=" + code + "&grant_type=authorization_code"; String resp = restTemplate.getForObject(url, String.class); JSONObject json = JSON.parseObject(resp); String openid = json.getString("openid"); // 查库或新建用户，生成 token 返回

参数说明：appid和secret在小程序后台"开发管理 → 开发设置"里拿，secret绝对不能写在小程序端，只能放后端。grant_type固定是authorization_code。

4.2 获取手机号的正确姿势

获取手机号是毕设里高频需求，但坑也多。现在微信要求用button组件的open-type="getPhoneNumber"，用户点击后拿到加密的code，后端再解密或换号。

<button open-type="getPhoneNumber" bindgetphonenumber="getPhone">授权手机号</button>

getPhone(e) { if (e.detail.code) { request('/wx/phone', 'POST', { code: e.detail.code }).then(phone => { console.log('手机号', phone); }); } }

注意：e.detail.code是新版接口返回的，老教程里写的encryptedData+iv已经过时。后端拿到 code 后调微信的getPhoneNumber接口换真实号码。这个功能需要小程序主体是企业认证，个人号用不了，毕设如果只是演示，可以先用假数据绕过。

4.3 token 校验与拦截器

登录之后，怎么保证接口安全？常见做法是后端加一个拦截器，校验请求头里的 token。

public class AuthInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest req, HttpServletResponse resp, Object handler) { String token = req.getHeader("token"); if (token == null || !tokenService.verify(token)) { resp.setStatus(401); return false; } return true; } }

在spring-mvc.xml里配置拦截路径，把/wx/login、/user/register这类公开接口排除掉。小程序端在request.js里统一往 header 塞 token，这样业务代码不用关心鉴权。

5. 订单状态流转与并发问题：寄养平台最容易翻车的地方

5.1 订单状态机怎么设计

寄养订单不是简单的增删改查，它有明确的状态流转。用状态机思路设计，能避免很多脏数据：

0 待接单：宠物主下单后
1 已接单：寄养家庭确认
2 寄养中：宠物实际入住
3 已完成：寄养结束
4 已取消：任一方取消

每次状态变更都要校验前置状态，比如只有 0 能变 1，只有 1 能变 2。在 Service 层写：

public void acceptOrder(Long orderId, Long hostId) { Orders order = orderMapper.selectById(orderId); if (order.getStatus() != 0) { throw new RuntimeException("订单状态不允许接单"); } if (!order.getHostId().equals(hostId)) { throw new RuntimeException("无权操作此订单"); } order.setStatus(1); orderMapper.updateById(order); }

这段代码看着对，但并发下有问题：两个请求同时进来，都查到 status=0，都通过校验，结果重复接单。解决办法是用乐观锁或数据库行锁。

5.2 并发接单的两种解法

乐观锁：在 orders 表加version字段，更新时带上版本号。

UPDATE orders SET status = 1, version = version + 1 WHERE id = #{id} AND status = 0 AND version = #{version}

判断影响行数，如果是 0 说明被别人抢先了，返回"手慢了"。

悲观锁：在查询时加FOR UPDATE。

SELECT * FROM orders WHERE id = #{id} FOR UPDATE

这种方式简单但会锁行，高并发下性能差。毕设场景用乐观锁足够，还能在答辩时讲出"我考虑了并发"这个加分点。

5.3 寄养容量校验

寄养家庭有容量上限，比如最多同时寄养 3 只。下单时要检查该家庭在指定日期区间内是否已满：

SELECT COUNT(*) FROM orders WHERE host_id = #{hostId} AND status IN (1, 2) AND start_date <= #{endDate} AND end_date >= #{startDate}

这个查询判断日期区间是否重叠，是寄养、酒店类系统的通用逻辑。注意status IN (1,2)只统计有效订单，已取消和已完成的不占容量。日期比较用<=和>=而不是<和>，因为同一天入住也算重叠。

6. 避坑与排查：SSM 小程序项目最常见的五个翻车点

6.1 中文乱码从数据库到页面全链路

现象：数据库里存的中文正常，但小程序显示成问号或方块。

原因：字符集在某一环断了。可能是数据库建库时用了latin1，可能是 JDBC URL 没写characterEncoding，也可能是 Tomcat 的server.xml没配URIEncoding="UTF-8"。

解决：按链路逐段排查。建库用utf8mb4，JDBC URL 加characterEncoding=utf8，Tomcat 的 Connector 加URIEncoding="UTF-8"，小程序端wx.request的 header 里content-type用application/json。四段都对齐，乱码必消。

6.2 跨域请求被浏览器拦截

现象：小程序开发者工具里请求报request:fail或者浏览器调试时报 CORS 错误。

原因：小程序本身不受浏览器同源策略限制，但如果你用浏览器直接调后端接口测试，就会遇到跨域。另外开发者工具没勾"不校验合法域名"也会拦。

解决：开发阶段勾选"不校验合法域名"；如果确实需要跨域，后端加一个 CORS 过滤器，设置Access-Control-Allow-Origin。但小程序正式环境不需要 CORS，因为它是原生请求不是浏览器请求。

6.3 MyBatis 的 mapper 扫描不到

现象：启动报Invalid bound statement (not found)。

原因：三种可能——Mapper 接口没被扫描到、XML 文件路径不对、接口方法名和 XML 的id对不上。

解决：检查applicationContext.xml里的MapperScannerConfigurer的basePackage是否覆盖了接口所在包；检查mybatis-config.xml或sqlSessionFactory的mapperLocations是否指向classpath:mapper/*.xml；最后核对方法名。这三个地方挨个看，基本能定位。

6.4 小程序真机预览白屏

现象：模拟器正常，真机预览白屏或报网络错误。

原因：BASE_URL还是localhost，手机访问不到；或者电脑防火墙拦了 8080；或者手机和电脑不在同一网段。

解决：把BASE_URL换成电脑局域网 IP，用ipconfig查；关闭 Windows 防火墙的入站规则或放行 8080；确认手机 WiFi 和电脑一致。如果还不行，用手机浏览器访问http://电脑IP:8080/pet/user/list，能返回 JSON 说明网络通，问题在小程序配置。

6.5 订单时间格式前后端不一致

现象：小程序传的日期后端解析报错，或者数据库存进去差 8 小时。

原因：小程序Date对象转 JSON 默认是 ISO 格式带时区，后端@DateTimeFormat没配；或者 MySQL 的serverTimezone没设对。

解决：统一用字符串yyyy-MM-dd传日期，后端用@DateTimeFormat(pattern = "yyyy-MM-dd")接收；JDBC URL 里serverTimezone=Asia/Shanghai；实体类的时间字段用java.util.Date配@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")。三处对齐，时间就不会飘。

7. 让毕设更扎实：接口文档、演示数据与答辩技巧

做到能跑通只是及格线，想让这份宠物寄养平台在答辩时拿高分，还得在几个细节上多花点功夫。我一般会做三件事。

第一，补一份接口文档。不用多正式，用 Markdown 列清楚每个接口的 URL、方法、参数、返回示例就行。答辩时老师问"你这个下单接口怎么设计的"，你直接翻文档，比现场回忆强得多。文档还能帮你自查：接口命名是否统一、返回结构是否一致、错误码是否覆盖全。

第二，造一批像样的演示数据。空数据库演示很尴尬，老师点进去全是"暂无数据"。用 SQL 脚本插 10 个用户、20 只宠物、15 个寄养家庭、30 条订单，状态覆盖 0 到 4。数据要真实一点，宠物名用"豆豆""咪咪"，地址用真实城市，别用"测试1""测试2"。这样演示时页面饱满，评价、筛选、分页功能都能展示出来。

第三，准备一个"技术亮点"话术。毕设答辩最怕被问"你这个有什么难的"。提前想好两三个点：比如订单并发用了乐观锁、登录用了 token 拦截器、日期区间重叠查询用了复合索引。每个点准备一句"为什么这么做"和一句"不做会怎样"。比如乐观锁，不做就会重复接单；索引，不做大数据量下查询会慢。这样老师一听就知道你是真做过，不是抄的。

最后说个我自己的习惯：每次改完代码，先本地跑一遍完整流程——登录、下单、接单、完成、评价，五步走通再提交。毕设项目功能不多，但链路长，一个字段改错可能整条流程断掉。养成"改完必走全流程"的习惯，能省下大量答辩前通宵排查的时间。希望帮到你。

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