Java+微信小程序宠物医院预约系统课设毕设实战指南

简介本资源是一套面向计算机相关专业学生如计科、大数据、人工智能、物联网等的高分课程设计项目聚焦宠物医院预约场景提供完整的微信小程序后端Java源码与配套MySQL数据库解决线上预约挂号、医生排班、宠物信息管理等核心业务需求适合作为课设、期末大作业或毕业设计基础框架。压缩包共49个文件含35个Java业务逻辑类、8个XML配置与Mapper映射文件、1个application.yml配置、1个SQL建库脚本、1个README说明文档等结构清晰涵盖Spring Boot后端服务、MyBatis数据访问及基础前端对接能力整体仅95KB轻量易部署。已有171人学习下载资源经实际验证可稳定运行附带详细项目说明与目录指引支持快速理解模块划分如pom依赖管理、petsdn.sql建库脚本、src主干结构并具备良好拓展性便于二次开发定制化功能。1. 这不是“微信小程序Java”拼凑出来的玩具项目它是一套能跑通挂号、问诊、处方、结算全链路的轻量级医疗预约系统专为课设答辩和毕设原型而生你手头这个高分课设新项目-基于Java开发的宠物医院预约微信小程序源码数据库.zip表面看是“Java后端 微信小程序前端”的常规组合但实际踩中了高校课设最痛的三个点业务闭环不完整、前后端联调总报错、数据库表设计脱离真实场景。我带过6届计算机专业毕业设计每年都有学生用“仿美团外卖”“仿豆瓣电影”交差结果答辩被问一句“你的订单状态怎么回滚”就卡住——而这个项目从微信登录态接管、宠物档案绑定、医生排班冲突校验、到预约号生成与短信模拟含数据库事务控制每一步都按真实宠物医院最小可行流程建模。它不追求高并发或微服务架构但把Spring Boot 2.7.x MyBatis-Plus MySQL 5.7 微信小程序原生框架非uniapp四者之间的数据契约、错误透传、日志埋点全部对齐。适合两类人一是大三下刚学完JDBC和小程序基础需要一个“改两行代码就能演示完整流程”的压箱底项目二是指导老师想快速验证学生是否真懂“接口怎么定义、事务怎么加、小程序怎么拿token”而不是只会抄wx.request()。别被“课设”二字误导——它的数据库ER图里有pet_owner、vet_schedule、appointment_record三张核心表字段命名带业务语义如is_confirmed TINYINT(1) COMMENT 0待确认,1已确认,2已取消不是user_info、data_table1这种应付式命名。2. 搭建环境先让Java后端跑起来再连上小程序——绕开pom.xml里最常翻车的3个依赖陷阱这个项目不是“解压即运行”它的pom.xml刻意保留了教学痕迹既用了较新的MyBatis-Plus 3.4.3.4支持LambdaQueryWrapper又没升级到Spring Boot 3.x避免JDK17兼容问题。很多同学直接mvn clean install失败根本原因不在代码而在pom.xml里三个被忽略的细节。2.1 确认JDK版本与Spring Boot的隐性绑定关系项目默认要求JDK 8u291 或 JDK 11.0.15注意不是任意JDK 11。Spring Boot 2.7.x 在JDK 17下会触发javax.xml.bind.JAXBException异常——这是JAXB从JDK 11起移出标准库导致的。解决方案不是降级JDK而是显式添加依赖!-- pom.xml 中 dependencies 内追加 -- dependency groupIdjavax.xml.bind/groupId artifactIdjaxb-api/artifactId version2.3.1/version /dependency dependency groupIdorg.glassfish.jaxb/groupId artifactIdjaxb-runtime/artifactId version2.3.1/version /dependency提示不要用jakarta.xml.bind:jakarta.xml.bind-api替代该项目所有XML解析逻辑如微信支付回调验签仍基于javax.*包路径强行替换会导致ClassCastException。2.2 MySQL驱动必须锁定8.0.28版本项目数据库脚本schema.sql里建表语句含JSON类型字段如pet_medical_history JSON COMMENT 就诊记录快照这要求MySQL驱动必须支持JSON解析。但Spring Boot 2.7.x默认引入的mysql-connector-java 8.0.28在某些Linux发行版如Ubuntu 22.04自带OpenJDK下会因SSL握手失败报Communications link failure。解决方法是在application.yml中强制关闭SSL并指定时区spring: datasource: url: jdbc:mysql://localhost:3306/pet_hospital?useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: your_password注意allowPublicKeyRetrievaltrue是MySQL 8.0连接必需参数漏写会导致Could not create connection to database server且错误日志不提示具体原因。2.3 微信小程序登录态校验依赖需手动补全项目后端用wx.login返回的code向微信服务器换取openid但pom.xml里只写了httpclient没配fastjson微信官方API返回JSON格式。若不添加WxLoginService.java中JSON.parseObject(response, WxLoginResp.class)会抛JSONException。补全方式dependency groupIdcom.alibaba/groupId artifactIdfastjson/artifactId version1.2.83/version !-- 必须≤1.2.83更高版本与Spring Boot 2.7.x存在Jackson冲突 -- /dependency3. 数据库初始化用schema.sql建库后必须执行的3条初始化SQL才能让小程序登录成功很多人导入schema.sql后小程序前端调/api/login/wx始终返回{code:500,msg:系统异常}查日志发现NullPointerException——问题不在Java代码而在数据库缺失关键初始化数据。schema.sql只建表不插数据以下三条SQL必须手动执行3.1 插入默认管理员账号否则无法进入后台管理页INSERT INTO sys_user (id, username, password, real_name, phone, status, create_time) VALUES (1, admin, $2a$10$ZzGQqXvYjKkLmNpOqRtSvUwXyZaBcDfEgHiJkLmNoPqRsTuVwXyZa, 系统管理员, 13800138000, 1, NOW());密码是BCrypt加密后的admin123直接复制粘贴即可。$2a$10$...开头是BCrypt标识Spring Security会自动识别。3.2 初始化医生排班模板否则小程序选医生时列表为空INSERT INTO vet_schedule (id, vet_id, date, time_slot, max_appointments, current_appointments, status) VALUES (1, 1, 2024-06-01, 09:00-10:00, 5, 0, 1), (2, 1, 2024-06-01, 10:00-11:00, 5, 0, 1), (3, 2, 2024-06-01, 14:00-15:00, 3, 0, 1);vet_id必须对应sys_user表中角色为doctor的用户ID默认id1是管理员id2是医生。若未插入医生用户先执行INSERT INTO sys_user (id, username, password, real_name, phone, status, role, create_time) VALUES (2, doctor001, $2a$10$ZzGQqXvYjKkLmNpOqRtSvUwXyZaBcDfEgHiJkLmNoPqRsTuVwXyZa, 张医生, 13900139000, 1, doctor, NOW());3.3 配置微信公众号AppID与AppSecret否则登录态校验永远失败INSERT INTO sys_config (config_key, config_value, remark) VALUES (wx.appid, wx1234567890abcdef, 微信公众号AppID), (wx.appsecret, abcdefghijklmnopqrstuvwxyz123456, 微信公众号AppSecret), (wx.mch_id, 1234567890, 微信支付商户号);这三条配置存于sys_config表后端通过Value(${wx.appid})注入。若用测试号AppID和AppSecret可在 微信公众平台测试号管理页 获取。切记测试号AppSecret每次重置都会变换一次就得更新数据库4. 小程序前端联调避开“登录成功但跳转空白页”的3个路由与状态陷阱小程序端代码在miniprogram/目录下结构清晰pages/、utils/、app.js但新手常卡在“微信开发者工具显示登录成功页面却停在loading页”。这不是后端问题而是小程序自身机制与项目约定的冲突。4.1app.js里的全局登录态检查必须等wx.getStorageSync完成项目在app.js的onLaunch中调用checkLoginStatus()该函数内部用wx.getStorageSync(token)读取本地缓存。但若用户首次打开缓存为空checkLoginStatus()会立即调用wx.login()获取code再发请求给后端。问题在于wx.login()是异步的而onLaunch后续代码如wx.switchTab可能在login回调前执行导致页面跳转时token还未写入缓存。正确做法是将跳转逻辑放入login成功回调// app.js 中 checkLoginStatus() 的关键修正 wx.login({ success: (res) { wx.request({ url: https://localhost:8080/api/login/wx, method: POST, data: { code: res.code }, success: (resp) { if (resp.data.code 200) { wx.setStorageSync(token, resp.data.data.token); wx.setStorageSync(userInfo, resp.data.data.user); // ✅ 此处才执行页面跳转 if (getApp().globalData.needRedirect) { wx.switchTab({ url: /pages/index/index }); } } } }); } });4.2 页面路由必须用switchTab而非navigateTo访问tabBar页项目app.json定义了tabBartabBar: { list: [ { pagePath: pages/index/index, text: 首页 }, { pagePath: pages/appointment/index, text: 预约 }, { pagePath: pages/my/index, text: 我的 } ] }若在pages/login/login.js中用wx.navigateTo({url: /pages/index/index})跳转会因tabBar页不支持navigateTo而白屏。必须用wx.switchTab// pages/login/login.js 登录成功后 wx.switchTab({ url: /pages/index/index }); // ✅ 正确 // wx.navigateTo({ url: /pages/index/index }); ❌ 错误白屏4.3pages/index/index.js的onLoad里必须主动触发数据加载首页index.wxml用block wx:for{{appointments}}渲染预约列表但appointments数据在onLoad中通过wx.request获取。若网络稍慢页面渲染时appointments还是空数组导致列表空白。解决方案在onLoad中加骨架屏并用setData触发重绘onLoad() { this.setData({ isLoading: true }); // 显示loading wx.request({ url: https://localhost:8080/api/appointment/list, header: { Authorization: wx.getStorageSync(token) }, success: (res) { this.setData({ appointments: res.data.data || [], isLoading: false }); } }); }isLoading: true对应wxml中的view wx:if{{isLoading}}加载中.../view避免白屏等待。5. 常见问题排查5条血泪经验覆盖90%课设调试失败场景注意以下问题均来自真实课设辅导记录按出现频率排序。每条包含现象、根因、解决步骤不讲原理只给解法。5.1 现象小程序点击“立即预约”报错request:fail ssl hand shake error原因微信开发者工具默认启用HTTPS校验但本地后端用HTTP协议http://localhost:8080。解决微信开发者工具 → 右上角「详情」→「本地设置」→ 勾选「不校验合法域名、web-view业务域名、TLS版本以及HTTPS证书」project.config.json中确保miniprogramRoot: miniprogram/路径正确避免静态资源404引发连锁错误。5.2 现象后台管理页/admin输入账号密码后跳转到/login循环重定向原因SysUserServiceImpl.java中login()方法校验密码时passwordEncoder.matches()返回false但日志被logback-spring.xml设为WARN级别控制台不输出。解决打开resources/logback-spring.xml将logger namecom.pet.hospital.service.impl levelDEBUG/查看日志中Password does not match提示确认数据库sys_user.password字段值是否为BCrypt加密以$2a$开头若是明文密码用在线BCrypt工具如https://bcrypt-generator.com加密后更新数据库。5.3 现象预约成功后医生端/admin/vet/schedule看不到新增预约记录原因AppointmentService.java中createAppointment()方法开启事务但Transactional注解未生效——因为该类被Service标记而事务管理器TransactionAutoConfiguration未扫描到com.pet.hospital.service包。解决检查Application.java上的SpringBootApplication是否含scanBasePackages com.pet.hospital若没有在SpringBootApplication上添加SpringBootApplication(scanBasePackages com.pet.hospital) public class PetHospitalApplication { ... }5.4 现象小程序提交预约后数据库appointment_record表status字段为NULL而非预期的1已预约原因AppointmentController.java中create()方法接收AppointmentDTO对象但DTO类AppointmentDTO.java的status字段未加TableField(fill FieldFill.INSERT)注解MyBatis-Plus插入时忽略该字段。解决打开com.pet.hospital.dto.AppointmentDTO找到private Integer status;在其上方添加注解TableField(fill FieldFill.INSERT) private Integer status;同时在Appointment.java实体类中对应字段也加相同注解确保自动填充生效。5.5 现象修改application.yml数据库密码后启动报错Access denied for user rootlocalhost原因MySQL 5.7默认启用validate_password插件要求密码含大小写字母数字特殊字符而application.yml中写的密码太简单如123456。解决登录MySQLmysql -u root -p执行SET GLOBAL validate_password.policyLOW; SET GLOBAL validate_password.length4;再重启Spring Boot应用。6. 让项目真正“高分”的3个进阶技巧从课设到毕设的临门一脚做到上面五章项目已能稳定运行、通过答辩基础提问。但要拿高分得让老师一眼看出“这学生真懂落地细节”而不是只会CtrlC/V。我带过的高分案例无一例外做了以下三件事——它们都不需要改核心业务逻辑只需在现有代码上加几行。6.1 给预约号加业务前缀让老师一眼认出这是“宠物医院”而非“XX商城”当前预约号是纯数字如202405281001缺乏业务辨识度。在AppointmentService.java的createAppointment()方法里把appointmentNo生成逻辑从System.currentTimeMillis()改为带前缀的字符串// 原代码约第87行 String appointmentNo String.valueOf(System.currentTimeMillis()); // 替换为 String prefix PET; // 宠物医院缩写 String timestamp String.valueOf(System.currentTimeMillis()).substring(2); // 取后10位避免过长 String appointmentNo prefix timestamp String.format(%04d, new Random().nextInt(10000)); // 生成如 PET24052810011234效果数据库appointment_record.appointment_no字段变为PET24052810011234老师翻表时立刻明白业务领域。此改动不影响任何接口仅增强可读性。6.2 在医生排班页加“今日可约”标签用CSS变量实现主题色统一pages/admin/vet/schedule.wxml中每个排班卡片需标注“今日可约”。项目已定义CSS变量--primary-color: #4CAF50;绿色但未使用。在schedule.wxss中添加.tag-today { display: inline-block; padding: 2px 8px; font-size: 12px; color: white; background-color: var(--primary-color); border-radius: 4px; margin-left: 8px; }然后在schedule.wxml的view classschedule-item内插入view wx:if{{item.date today}} classtag-today今日可约/view关键点today需在schedule.js的data中定义为new Date().toISOString().split(T)[0]格式2024-05-28并与item.date字符串比对。这样老师看到绿色标签就知道你连日期格式化都考虑到了。6.3 用Scheduled实现每日凌晨自动清理过期预约体现工程思维项目没做定时任务但加一个很简单在com.pet.hospital.task包下新建CleanExpiredAppointmentTask.javaComponent Slf4j public class CleanExpiredAppointmentTask { Autowired private AppointmentMapper appointmentMapper; Scheduled(cron 0 0 0 * * ?) // 每天0点0分执行 public void cleanExpired() { int count appointmentMapper.deleteExpired(); log.info(清理过期预约记录 {} 条, count); } }再在AppointmentMapper.java中添加方法Delete(DELETE FROM appointment_record WHERE status 0 AND create_time DATE_SUB(NOW(), INTERVAL 3 DAY)) int deleteExpired();最后别忘了在Application.java上加EnableScheduling。这个功能老师未必会测但当你在答辩时说“我加了定时清理避免数据库积压无效数据”他会立刻给你加1分——因为这暴露了你对生产环境的认知。我带学生做课设时反复强调高分不来自功能堆砌而来自对“为什么这样设计”的诚实交代。比如你在答辩PPT里写“预约号加PET前缀是为了在多系统共存时快速定位业务归属”“清理过期预约用cron而非监听事件是因为定时任务更可控避免高并发下单时触发雪崩”。这些话不需要技术多深但能让老师相信你写的不是代码是思考。希望帮到你。本文还有配套的精品资源点击获取