SSM架构宠物养护小程序：从请求链路到数据库设计的完整实践

简介这是一份基于JavaSSMMySQL微信小程序技术栈的宠物养护管理小程序毕业设计资源面向计算机相关专业学生可用于毕业设计、课程设计或期末大作业。系统涵盖宠物养护管理、健康记录、用品购买、社交互动等核心功能前后端代码完整并配套论文与数据库脚本下载后经严格调试即可运行。压缩包共1275个文件约15.06MB包含Java源码、Vue前端、微信小程序页面文件wxml/wxss/js、数据库SQL脚本及项目部署配置等文件类型覆盖png、js、svg、vue、java、json、wxss、wxml等结构清晰便于按模块查阅。目前已有63人学习使用项目经过导师指导并获得高分评价适合希望快速搭建完整小程序项目、掌握SSM与微信小程序整合开发的学习者参考。1. 宠物小程序不只是一张档案表SSM 架构里藏着真正的工程量做过微信小程序的人都知道前端渲染一个宠物列表不难难的是把「登录态、健康记录、用品订单、社交动态」这几条线在一个单体项目里理清楚。这份基于 Java SSM MySQL 微信小程序的宠物养护管理毕业设计表面上是一套可以交差的课程作业实际拆开看它的请求链路、表结构设计、以及小程序端和 Java 后端的联调方式踩过的坑不比一个正式上线项目少。项目源码、数据库脚本、部署工具都打包在内下载后导入 IDEA 配好 Maven 就能跑适合三类人拿它当毕业设计底子的学生、想快速上手 SSM 整合流程的初级工程师、以及需要一套带管理后台的宠物业务 Demo 做二次开发的开发者。后端是经典的 Spring SpringMVC MyBatis 三件套前端是微信原生小程序数据库用 MySQL 5.7 以上版本整套东西没有花哨的中间件反而更容易看清业务代码怎么写。2. SSM 整合与小程序端请求链路从 wx.request 到 MyBatis 映射的完整闭环2.1 为什么这个项目选 SSM 而不是 Spring Boot现在新项目几乎清一色 Spring Boot但这套毕业设计选 SSM 是有历史原因的。Spring Boot 的自动配置把大量 XML 配置藏起来了学生做完项目还是不知道 Bean 怎么注入、事务怎么切、MyBatis 的 SqlSessionFactory 怎么组装。SSM 要求你手写applicationContext.xml、spring-mvc.xml、mybatis-config.xml每一个配置项都暴露在明面上。说实话对于理解 Java Web 底层运行机制这件事SSM 反而比 Spring Boot 更有教学价值。这个项目里你会在源码中看到spring-mybatis.xml里配置的数据源、连接池、Mapper 扫描路径这些内容在 Spring Boot 项目中通常被MapperScan和application.yml几句话带过少了很多可以琢磨的细节。这套结构的请求链路是标准的四层模型微信小程序端通过wx.request发起 HTTP 请求到 SpringMVC 的DispatcherServletHandlerMapping根据 URL 找到对应的ControllerController 调 Service 接口Service 实现类通过 MyBatis 的 Mapper 接口操作 MySQL 数据库。数据再原路返回 JSON 给小程序端渲染。理解这条链路后续不管是加接口还是查 Bug 都有明确方向。2.2 核心请求流转配置web.xml 与 SpringMVC 的入口设置先看后端入口配置。SSM 项目没有 Spring Boot 那种内嵌 Tomcat它打包成 WAR 包部署到外部 Tomcat。web.xml里注册了两个核心组件ContextLoaderListener负责加载 Spring 根容器DispatcherServlet负责 SpringMVC 子容器。web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd version4.0 !-- Spring 根容器 -- context-param param-namecontextConfigLocation/param-name param-valueclasspath:spring/applicationContext-*.xml/param-value /context-param listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener !-- SpringMVC 前端控制器 -- servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring/spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mapping /web-app两个容器的职责边界要注意Spring 根容器管 Service、Mapper、数据源这些业务底层 BeanSpringMVC 子容器只管 Controller 和视图解析器。如果扫描配置写重复了比如applicationContext.xml里也扫描了Controller会导致事务代理失效这类隐蔽问题。项目里的做法是根容器用context:component-scan时配置exclude-filter排除Controller注解SpringMVC 容器里只扫描Controller这个细节很多学生在答辩时被问住值得重点看源码里spring-mvc.xml的context:component-scan配置。2.3 MyBatis 会话工厂与 Mapper 接口绑定MyBatis 的整合是 SSM 里最容易出错的一环。这个项目的spring-mybatis.xml里配置了SqlSessionFactoryBean注意它需要一个mapperLocations属性指向 XML 映射文件的位置。bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property nameconfigLocation valueclasspath:mybatis/mybatis-config.xml/ property namemapperLocations valueclasspath:mybatis/mapper/*.xml/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.pet.mapper/ /bean这里mapperLocations指定的是classpath:mybatis/mapper/*.xml意味着每一张表的 SQL 语句都写在独立的 XML 文件里。MapperScannerConfigurer会自动扫描com.pet.mapper包下的接口生成代理对象注入到 Service 层。实际开发中常见的坑有两个一是接口和 XML 文件的 namespace 不匹配启动时报BindingException二是接口方法名和 XML 里的id不一致调用时同样报错。项目里表的命名是tb_pet_info这种带前缀的风格接口文件放在com.pet.mapper包下XML 放在mybatis/mapper目录下一一对应关系非常清晰。2.4 小程序端发起请求wx.request 的封装与数据回显微信小程序端没有 axios官方提供的是wx.requestAPI。项目里后端接口统一返回 JSON 格式小程序端在utils/request.js里封装了请求方法处理了登录态 token 和错误码。function request(url, method, data) { return new Promise((resolve, reject) { wx.request({ url: getApp().globalData.baseUrl url, method: method || GET, data: data || {}, header: { Content-Type: application/json, token: wx.getStorageSync(token) }, success: (res) { if (res.data.code 200) { resolve(res.data.data) } else { wx.showToast({ title: res.data.msg, icon: none }) reject(res.data) } }, fail: (err) reject(err) }) }) }baseUrl在app.js的globalData里配置本地开发时指向http://localhost:8080/pet_ssm这个路径要跟后端项目的context-path保持一致。真机调试时必须是 HTTPS 域名加合法证书开发阶段可以在微信开发者工具里勾选「不校验合法域名」。token从本地缓存读取每次请求带上后端根据 token 识别用户身份。这里有个细节如果后端接口返回的 code 不是 200前端统一弹 toast 提示而不是让业务页面各自处理错误这在多页面小程序项目里能少写很多重复逻辑。3. 宠物档案与健康记录模块MySQL 表结构设计与 MyBatis 动态 SQL 实战3.1 核心业务表从 ER 关系到建表语句宠物养护系统的核心数据模型围绕三个要素用户、宠物、记录。用户表存微信用户的 openid宠物表存宠物档案信息健康记录表存每次体检、疫苗、驱虫的历史记录。另外还有用品表、订单表、社交动态表分别对应购买和社区功能。先用表格看清核心表结构表名用途关键字段关联关系tb_user小程序用户id,openid,nickname,avatar_url被宠物表、订单表引用tb_pet_info宠物档案id,user_id,pet_name,breed,birthday,gender,sterilizationuser_id 关联 tb_user.idtb_health_record健康记录id,pet_id,record_type,record_date,description,next_datepet_id 关联 tb_pet_info.idtb_product宠物用品id,product_name,price,stock,image_url无直接关联tb_order订单id,order_no,user_id,total_amount,status,create_timeuser_id 关联 tb_user.idtb_comment社交动态id,user_id,content,image_url,create_timeuser_id 关联 tb_user.idtb_health_record的record_type字段是枚举值用varchar(20)存储取值有vaccine疫苗、deworm驱虫、checkup体检、grooming美容。不建字典表是因为这张表的记录量相对有限小程序端下拉框直接硬编码枚举值减少了 JOIN 查询。建表 SQL 项目里已经提供但其中tb_pet_info的索引设计值得单独看。user_id是高频查询条件项目在建表时给它加了普通索引否则随着用户量增长WHERE user_id ?的查询会全表扫描。CREATE TABLE tb_pet_info ( id INT(11) NOT NULL AUTO_INCREMENT COMMENT 主键ID, user_id INT(11) NOT NULL COMMENT 所属用户ID, pet_name VARCHAR(50) NOT NULL COMMENT 宠物昵称, breed VARCHAR(50) DEFAULT NULL COMMENT 品种, birthday DATE DEFAULT NULL COMMENT 出生日期, gender TINYINT(1) DEFAULT 1 COMMENT 性别1公 2母, sterilization TINYINT(1) DEFAULT 0 COMMENT 是否绝育0否 1是, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_user_id (user_id) ) ENGINEInnoDB AUTO_INCREMENT1 DEFAULT CHARSETutf8mb4 COMMENT宠物档案表;create_time用DEFAULT CURRENT_TIMESTAMP自动填充update_time加了ON UPDATE CURRENT_TIMESTAMP这样更新记录时时间戳自动维护不用在 Java 代码里手动setCreateTime(new Date())。性别字段用TINYINT存 1 和 2比存字符串省空间Java 端用枚举或者Integer接收后转成对应文案。3.2 MyBatis 动态 SQL健康记录的多条件筛选健康记录列表查询是典型的多条件筛选场景按宠物 ID、按记录类型、按时间范围。如果为每个组合写一条静态 SQL代码会非常冗余。项目里用了 MyBatis 的动态 SQL 标签来拼接查询条件看HealthRecordMapper.xml里的核心查询select idselectRecordList parameterTypemap resultTypecom.pet.entity.HealthRecord SELECT * FROM tb_health_record where if testpetId ! null AND pet_id #{petId} /if if testrecordType ! null and recordType ! AND record_type #{recordType} /if if teststartDate ! null and startDate ! AND record_date gt; #{startDate} /if if testendDate ! null and endDate ! AND record_date lt; #{endDate} /if /where ORDER BY record_date DESC /selectwhere标签会自动去掉第一个多余的AND这样当petId为空时不会生成WHERE AND ...的语法错误。record_date比较时用了gt;和lt;转义字符这是 XML 文件里写大于号小于号时必须注意的点直接写会导致 XML 解析失败。parameterTypemap意味着 Service 层传入的是一个MapString, Object参数名要和if里判断的字段名一致Controller 接收前端参数后封装成 Map 传入 Service。这里有个实践技巧项目里所有列表查询的分页没有用 PageHelper 插件而是手动在 SQL 末尾拼接LIMIT #{offset}, #{pageSize}因为该项目的列表接口不多引入 PageHelper 反而多一个插件依赖。如果你在二次开发时要新增列表页建议改用 PageHelper配置PageHelper.startPage(pageNum, pageSize)之后用 PageInfo 接收结果代码会更简洁。3.3 前端健康记录时间线与日历展示小程序端的健康记录页面用的是纵向时间线布局scroll-view组件包裹每条记录插入了一个数据卡片。记录卡片复用的record-item组件在properties里接收record对象通过observers监听数据变化后格式化日期。Component({ properties: { record: { type: Object, value: {} } }, observers: { record.recordDate: function(dateStr) { if (!dateStr) return const date new Date(dateStr.replace(/-/g, /)) const month date.getMonth() 1 const day date.getDate() this.setData({ displayDate: ${month}月${day}日, displayWeek: this.getWeek(date.getDay()) }) } }, methods: { getWeek(day) { const weeks [周日, 周一, 周二, 周三, 周四, 周五, 周六] return weeks[day] } } })dateStr.replace(/-/g, /)这一步很关键iOS 系统上new Date(2025-01-15)会直接报 Invalid Date只有转成斜杠格式才能正确解析这是小程序跨端开发中经典的兼容性问题。如果后端返回的日期字符串直接拿来展示Android 上正常iOS 上白屏排查的时候第一反应就应该是这里。4. 登录态与订单流程从 wx.login 到支付回调的完整业务闭环4.1 微信登录与后端 Session 管理小程序的登录流程跟传统 Web 不一样没有账号密码登录而是通过微信的wx.login接口换取code再在后端用code换openid。项目里的登录逻辑集中在WxUserController看核心代码PostMapping(/login) ResponseBody public Result login(RequestBody MapString, String params) { String code params.get(code); String nickname params.get(nickname); String avatarUrl params.get(avatarUrl); // 调用微信接口用 code 换取 openid String url https://api.weixin.qq.com/sns/jscode2session?appid appId secret appSecret js_code code grant_typeauthorization_code; String result httpClientUtil.doGet(url); JSONObject json JSONObject.parseObject(result); String openid json.getString(openid); // 查询用户是否存在不存在则注册 WxUser user wxUserService.findByOpenId(openid); if (user null) { user new WxUser(); user.setOpenid(openid); user.setNickname(nickname); user.setAvatarUrl(avatarUrl); wxUserService.register(user); } // 生成登录态 token String token UUID.randomUUID().toString().replace(-, ); redisUtil.set(token_ token, String.valueOf(user.getId()), 60 * 60 * 24 * 7); return Result.ok().put(token, token).put(user, user); }这段代码里两个关键点。第一jscode2session接口返回的字段里除了openid还有session_key但session_key绝对不能返回给前端也不应该存储到数据库它是解密用户手机号、unionId 等敏感信息的密钥。第二登录态用 token 机制而非 openid 直接当凭证是因为 openid 是永久性的用户标识如果泄露会暴露用户身份token 存 Redis 并设置 7 天过期时间用户每次请求携带 token后端根据 token 查 Redis 得到 user_id这种设计比每次请求都带 openid 去查库要快得多。项目用的 Redis 配置在spring-redis.xml里连接池用 Jedis序列化器用StringRedisSerializer处理 key、Jackson2JsonRedisSerializer处理 value如果直接存对象不配序列化器存进 Redis 的会是 Java 序列化的二进制乱码用 RedisDesktopManager 查看时完全读不出来。4.2 下单接口的事务边界宠物用品购买的下单流程涉及两张表的写操作tb_order插入一条订单记录、tb_order_item插入多条订单明细。这个操作必须加事务否则订单主表插入成功、明细插入失败会让订单成为脏数据。看OrderServiceImpl里的下单方法Override Transactional(rollbackFor Exception.class) public void createOrder(OrderDTO dto) { // 1. 生成订单号 String orderNo generateOrderNo(); Order order new Order(); order.setOrderNo(orderNo); order.setUserId(dto.getUserId()); order.setTotalAmount(dto.getTotalAmount()); order.setStatus(1); // 待支付 orderMapper.insert(order); // 2. 插入订单明细 for (OrderItemDetail item : dto.getItems()) { OrderItem orderItem new OrderItem(); orderItem.setOrderId(order.getId()); orderItem.setProductId(item.getProductId()); orderItem.setQuantity(item.getQuantity()); orderItem.setPrice(item.getPrice()); orderItemMapper.insert(orderItem); // 3. 扣减库存 productMapper.reduceStock(item.getProductId(), item.getQuantity()); } }Transactional(rollbackFor Exception.class)里的rollbackFor一定要写默认情况下 Spring 只对RuntimeException回滚如果方法抛的是Exception子类的 checked exception事务不会回滚库存扣了但订单没生成这种问题排查起来非常隐蔽。generateOrderNo()方法生成的订单号格式是yyyyMMddHHmmss加四位随机数高并发下单场景可能重复但在毕业设计这种量级下没问题如果要优化可以用 Redis 的INCR命令生成自增序列。reduceStock的 SQL 是典型的乐观锁扣减库存写法update idreduceStock UPDATE tb_product SET stock stock - #{quantity} WHERE id #{productId} AND stock gt; #{quantity} /updateWHERE id ? AND stock ?这个条件确保了只有一个线程能成功扣减库存避免超卖。reduceStock的返回值是受影响行数如果返回 0 说明库存不足Service 层需要检查这个返回值并抛出BusinessException触发事务回滚。很多学生在写扣库存时先查一次库存再 UPDATE两个操作之间存在时间窗口并发下必然超卖这个项目的写法是正确示范。4.3 订单状态的枚举驱动订单状态在tb_order表里用status字段表示取值有 1~5。Java 端用枚举类统一管理前端小程序按不同状态渲染不同操作按钮这种写法避免了魔法数字散落在代码各处。public enum OrderStatusEnum { PENDING_PAY(1, 待支付), PENDING_SHIPMENT(2, 待发货), PENDING_RECEIPT(3, 待收货), COMPLETED(4, 已完成), CANCELLED(5, 已取消); private final int code; private final String desc; OrderStatusEnum(int code, String desc) { this.code code; this.desc desc; } public static String getDescByCode(int code) { for (OrderStatusEnum status : values()) { if (status.code code) { return status.desc; } } return 未知状态; } public int getCode() { return code; } public String getDesc() { return desc; } }小程序端页面上「取消订单」「确认收货」按钮的显示逻辑直接跟状态码比对后端收到状态变更请求后先校验当前状态是否允许流转比如从「待支付」可以直接改到「已取消」但从「已完成」不能再改回「待支付」这块用一组长if/else或 switch 就能处理不复杂但必须做否则会出现状态跳变的数据异常。5. Maven 构建、微信开发者工具联调与加载页性能优化5.1 一套一键脚本解决环境搭建项目根目录下提供了三个批处理文件1-install.bat、2-run.bat、3-build.bat这是团队成员打包时留下的自动化脚本。1-install.bat执行 Maven 的依赖下载和本地安装2-run.bat启动 Tomcat 并部署项目3-build.bat构建 WAR 包。# 1-install.bat 核心内容 mvn clean install -Dmaven.test.skiptrue -Pdev # 3-build.bat 核心内容 mvn clean package -Dmaven.test.skiptrue -DwarNamepet_ssm-Dmaven.test.skiptrue跳过测试代码的编译和运行因为毕业设计项目通常没写单元测试跳过可以加快构建速度。-Pdev激活pom.xml里配置的 dev profile这个 profile 里定义了开发环境的数据库连接或配置中心地址。如果你要部署到生产环境改成-Pprod并修改 profile 下的配置项即可。第一次运行1-install.bat时 Maven 会从中央仓库下载依赖如果网络状况不好建议改用阿里云私服镜像修改settings.xml里的mirror节点可以显著提速。5.2 微信开发者工具的运行参数配置微信开发者工具导入小程序项目后project.config.json里的appid需要改成你自己的测试号或已注册的小程序 AppID否则真机预览功能被限制。app.js里的globalData.baseUrl要确保指向后端的实际访问路径。本地联调时后端跑在 Tomcat 默认端口 8080项目 context-path 是/pet_ssm所以完整访问地址是http://localhost:8080/pet_ssm。开发者工具右上角「详情」→「本地设置」里勾选「不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」否则所有请求都会被拦截。一个常规的联调顺序是这样先启动 MySQL 服务并导入数据库脚本再用 IDEA 打开后端代码等待 Maven 依赖加载完成启动 Tomcat 后浏览器访问http://localhost:8080/pet_ssm/api/pet/list能返回 JSON 数据最后打开微信开发者工具加载小程序项目。前端页面按「我的→宠物列表→添加宠物→健康记录」这个路径测试如果哪一步页面空白或数据不显示打开 Debug 模式看 Console 面板的报错信息后端接口问题看 IDEA 控制台的日志输出。这种从前端到后端层层递进的排查法定位到具体模块的效率最高。5.3 加载页优化的两个实践点如果首页内容较多小程序冷启动会有短暂白屏体验优化上有两个成本低见效快的方案本项目里已经踩过坑。微信小程序的分包加载能有效缩短首屏时间。把「订单列表」「社交动态」等低频页面拆到分包里主包只保留首页和个人中心核心页面。配置在app.json的subPackages字段里{ pages: [ pages/index/index, pages/pet/pet-list, pages/pet/pet-edit, pages/mine/mine ], subPackages: [ { root: packageOrder, pages: [ pages/order-list/order-list, pages/order-detail/order-detail ] }, { root: packageCommunity, pages: [ pages/community/community-list ] } ] }主包体积控制在 2MB 以内分包在加载时才下载对应代码包。静态图片资源尽量放 CDN 而不是本地images目录因为本地图片会全部打包进主包数十张图片就能让主包体积翻倍。项目里图片统一走/static路径引用远程地址目录下只保留了 tabBar 图标和少量启动图。wx.prefetch接口可以在页面加载时预拉取下一个页面需要的数据适合宠物详情页跳记录列表这类前后依赖的场景。这些优化手法不涉及后端代码改动纯前端就能完成适合在毕业设计答辩的演示环节讲给评委听能直接体现工程化意识。本文还有配套的精品资源点击获取