简介一套面向高校毕业设计及小程序开发初学者的民宿短租系统完整项目包含微信小程序前端与SSM后端以及MySQL数据库设计能帮助快速搭建可演示的民宿预订全流程。包体共996个文件约38.58MB涵盖java后端业务逻辑、vue/js小程序页面脚本、png/svg界面素材、xml/scss样式配置、sql数据库初始化脚本另有毕业论文文档与mp4视频演示目录结构完整。已有335人学习下载适合用于课程设计、毕业设计答辩或课余项目实战。资源解压后内含安装运行脚本可减少环境配置排错时间配套论文与视频能辅助理解前后端交互及民宿信息管理、在线预订、订单管理等核心模块值得参考复用。1. 民宿短租小程序毕业设计为什么这个题目能守住答辩底线又是毕业设计开题季。如果你在找一个“技术栈传统、业务闭环完整、演示效果直观”的题目民宿短租小程序近两年是性价比很高的选择。它由微信小程序、SSMSpring SpringMVC MyBatis和 MySQL 三部分组成前端在微信生态里跑后端是经典 Java Web 三层结构数据统一落在 MySQL。为什么能守住答辩底线因为业务链路从注册登录、房源浏览、搜索筛选到下单支付、订单管理、评价回复完整得像一个缩小版民宿预订平台但开发量控制在两三个月能完成的范围。适合谁Java 基础一般、想拿一个稳妥项目顺利毕业的同学以及想把这个主题扩展成简历项目、后续接真实需求的开发者。下面按我实际过过的一整套方案把环境、建库、后端启动、小程序联调和排障完整讲一遍。2. 系统架构与 SSM 选型后端、MySQL 数据表和小程序端怎么划分职责民宿短租小程序表面上是几个页面加一组接口内核其实是三件事小程序把用户动作包装成 HTTP 请求SSM 后端把请求转成 SQL 再返回 JSONMySQL 把用户、房源、订单这些状态持久化。动手写代码之前先把这个边界划清楚后面写代码、写论文、画时序图基本不用返工。我习惯花两天专门定模块边界和数据字段真正写接口反而很快。2.1 三层架构的边界Controller、Service、Mapper 各自管什么SSM 是 Spring SpringMVC MyBatis 的组合Spring 管对象生命周期和事务SpringMVC 把小程序发来的 URL 映射到 Java 方法MyBatis 负责 Java 方法和 MySQL 表之间的 SQL 映射。对应到民宿项目里一条“获取房源列表”的请求会这样走小程序端wx.request发出GET /api/house/list?city杭州pageNum1SpringMVC 找到HouseController里的对应方法方法调用HouseService做业务过滤HouseServiceImpl再调HouseMapper接口最终在HouseMapper.xml里执行对 house 表的查询结果转成 JSON 回到页面。后端一般拆成 controller、service、mapper 三个包实体类放 entity 或 pojo 包。Controller 层只负责接收参数、校验格式、返回结果不碰 SQLService 层写业务规则比如民宿下单前要检查房源是否可订、日期是否重叠Mapper 层是接口加 XMLSQL 全部收敛在这里。答辩时画架构图这张图就是最核心的一张。Controller RequestMapping(/api/house) public class HouseController { Autowired private HouseService houseService; ResponseBody GetMapping(/list) public Result list(RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, String city, String keyword) { // SpringMVC 直接把 URL 上的参数绑定进来mybatis 层负责动态 SQL return Result.ok(houseService.pageQuery(pageNum, pageSize, city, keyword)); } }这里有两个容易被新手忽略的点。第一ResponseBody不能丢丢了会走视图解析器最后小程序收到的是 HTML 而不是 JSON。第二RequestParam(defaultValue 1)必须写默认值小程序端如果不传 pageNumSpring 会直接报参数缺失。分页参数统一从请求里来不要在后端写死。2.2 民宿短租的 MySQL 表设计四张表撑起完整业务闭环一个不过度设计的基础版民宿短租项目四张表就够了用户表、房源表、订单表、评价表。用户表区分普通用户和房东房源表挂在房东名下订单表记录谁在什么时间租了哪套房评价表关联订单和房源。用户表设计时 role 字段是重点我一般用 tinyint0 普通用户、1 房东、2 管理员。这样登录后前端可以按角色渲染不同入口房东能看到“我的房源”和“接单列表”普通用户看到“我的订单”管理员看到后台数据统计。这个角色设计虽然简单却是答辩时能讲明白权限控制的亮点。CREATE TABLE booking ( id int(11) NOT NULL AUTO_INCREMENT, order_no varchar(32) NOT NULL COMMENT 订单号前端生成HMS年月日随机数, user_id int(11) NOT NULL COMMENT 下单用户ID, house_id int(11) NOT NULL COMMENT 房源ID, check_in_date date NOT NULL COMMENT 入住日期, check_out_date date NOT NULL COMMENT 退房日期, total_price decimal(10,2) NOT NULL COMMENT 总价天数×每晚价格, status tinyint(4) NOT NULL DEFAULT 0 COMMENT 0待支付 1待入住 2已入住 3已完成 4已取消, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_order_no (order_no), KEY idx_user (user_id), KEY idx_house (house_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT民宿订单表;订单表是民宿项目的核心表。order_no必须唯一我见过有项目直接拿自增 id 当订单号这在演示时看不出问题但答辩评委只要一提“业务上订单号要全局唯一”现场就会卡壳。日期类型用 date 而不是 varchar后面做日期筛选、算入住天数都方便。总价用 decimal(10,2)绝不能用 floatfloat 算钱会有精度误差这是常识性扣分点。表之间我建议只保留逻辑外键不建物理外键约束。物理外键在删除房源、改用户时会带来一堆级联问题毕设阶段用代码层面保证引用完整性更省事。但索引不能省user_id、house_id、citystatus这类高频查询条件都要建普通索引。别在索引上省钱数据量小的时候看不出差别一旦演示时导入了上千条房源没有索引的like查询会慢得让人心慌。2.3 为什么不直接上 Spring Boot答辩视角的选型逻辑2025 年 Spring Boot 早已是主流但毕业设计用 SSM 并不落伍。SSM 的三层结构是教科书标准形态每一层都能对应到 Java 课程里学过的知识点IoC 容器、AOP 切面、声明式事务。SSM 的 XML 配置是显式的哪个 bean 注入了哪个依赖一眼能看见答辩时你可以把请求从进入 Controller 到 MyBatis 执行 SQL 的每一跳都讲清楚。Spring Boot 的自动配置像一个黑匣子学生往往只知道“加个注解就能跑”一问原理就容易露馅。SSM 稍微多写几行配置但这些配置都是你自己写出来的面试和答辩时反而能讲出细节。另一个务实的原因是SSM 相关的中文资料、论坛问答、视频教程存量巨大任何奇怪的报错基本都能搜到现成答案这对独立开发项目来说太重要了。如果评委追问“现在新项目谁还用 SSM”可以这样答Spring Boot 底层依然是 Spring SpringMVC MyBatis本项目选 SSM 是为了更透明地展示 Java Web 核心链路以民宿短租这种中小规模业务SSM 的性能和开发效率完全够用。把对比逻辑想清楚这反而成了加分项。选型的核心永远是“你为什么这么做”而不是“哪个框架更高级”。3. 本地搭建与后端启动数据库导入、配置修改与 Tomcat 部署环境搭建是最容易劝退的一步也是踩坑贡献最大的一个环节。很多同学卡在“代码有了但跑不起来”原因不是代码问题而是 JDK、Tomcat、MySQL、Maven 的版本组合不匹配。这一章按我验证过的组合来大概率一步到位。3.1 版本配对JDK 1.8、Tomcat 8、MySQL 5.7 与 Maven 3.6 的黄金组合SSM 是老牌技术栈最早一批工程都是基于 JDK 8 和 javax.* 命名空间写的。所以我的建议是JDK 1.8 Tomcat 8.5 MySQL 5.7 Maven 3.6。这个组合经过大量项目验证网上教程里 99% 的命令和配置可以直接抄。不要一上来装 JDK 17 或 Tomcat 10。JDK 17 运行没问题但 Tomcat 10 把javax.servlet改成了jakarta.servlet老 SSM 工程里所有用到 HttpServletRequest、HttpServletResponse 的代码全部要改包名凭空多出一堆编译错误。MySQL 也一样8.0 之后的驱动类和认证方式跟 5.7 不同如果不匹配最常见的报错是Communications link failure。我习惯把版本写进项目 README 的第一行避免换电脑后就“玄学”地跑不起来。Windows 装 MySQL 5.7 时zip 解压版比 MSI 安装版更好控制。解压后先做两件事手动创建my.ini指定 basedir 和 datadir然后用管理员权限打开命令行执行初始化命令。mysql 安装教程里最容易漏的就是这一步直接启动会报“服务没有响应控制功能”。# 管理员命令行进入 MySQL 解压目录 mysqld --initialize-insecure mysqld -install net start mysql--initialize-insecure会创建一个空密码的 root 用户本地开发完全够用。初始化之后立刻改密码避免后面连接时反复报错。Tomcat 8 不需要安装解压后配置一下 IDEA 里的本地服务路径就能用。Maven 3.6 记得配阿里云镜像否则首次拉十几 MB 依赖能等上半小时。3.2 数据库导入建库、导表和初始数据的一次性操作拿到项目源码后数据库部分通常是一个.sql文件。我一般先在命令行里建好库再执行 source 导入比在 Navicat 里右键运行更可控报错时能看到具体在哪一行。CREATE DATABASE IF NOT EXISTS minisu_pj DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE minisu_pj; source D:/workspace/minisu/sql/minisu.sql;建库时必须显式写utf8mb4。如果默认字符集是 latin1后面存中文就会变成问号而这个问题往往要等到联调阶段才暴露排查成本很高。source后面的路径用正斜杠Windows 反斜杠在 MySQL 命令里会被当成转义符这是一个非常隐蔽的坑。导入之后立刻做两件验证一是show tables;看四张核心表是否都在二是select * from house limit 5;看房源数据是否完好封面图和描述是否为中文。有些 sql 文件里插入了外键关联导入顺序错了会报Cannot add foreign key constraint如果遇到这种报错检查表之间是否有循环引用毕设阶段通常不会设计循环引用直接删掉外键约束就完事。初始数据里建议至少准备一个管理员账号、一个房东账号、一个普通用户账号、覆盖“杭州”“上海”两个城市的 10 条房源数据。数据和账号越接近真实场景后面小程序端演示时越省事不用每次都现场注册。3.3 Spring 配置与 Tomcat 启动数据源、上下文路径和常见报错SSM 配置集中在两个文件里jdbc.properties管数据库连接spring-mybatis.xml管数据源注入和 SQL 工厂。打开工程后先改这两个文件别急着启动。jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/minisu_pj?useUnicodetruecharacterEncodingutf8useSSLfalse jdbc.usernameroot jdbc.password123456characterEncodingutf8必须保留这是和前端中文乱码的第一道防线。如果你装的是 MySQL 8jdbc.driver要改成com.mysql.cj.jdbc.Driverurl 还要加serverTimezoneAsia/Shanghai否则会报时区错误。5.7 的组合能用就不要升级这是我对所有用 SSM 做毕设的同学的第一句忠告。在 IDEA 里启动 Tomcat 时Deployment 页签里的 Application context 要设置成/minisu。这决定了前端请求的完整路径是http://localhost:8080/minisu/api/house/list前端封装请求时 BASE_URL 也要对应写这个。上下文路径不一致会让前端所有请求 404而那些报错不是在 Tomcat 启动阶段出现的直接跑到小程序端去排查就绕远了。启动成功后先访问http://localhost:8080/minisu/api/house/list?pageNum1能看到 JSON 数据就说明后端通了再切到小程序端联调。4. 小程序端联调登录授权、房源列表、下单与模拟支付后端通了接下来就是把小程序端跑起来。这个阶段的关键词是“对齐”路径对齐、字段对齐、权限对齐。任何一处对不上表现都是页面空白或请求失败但真正的问题往往在后端日志里。4.1 导入微信开发者工具AppID、基础库和顶部导航栏适配用微信开发者工具导入小程序前端目录导入时开发者工具会要求填 AppID。如果没有注册小程序账号可以选择测试号测试号能跑通大部分页面逻辑但后面提到的手机号登录接口用不了。基础库版本建议设置在 2.10.0 以上太老的基础库不支持wx.request的部分新特性太新的基础库在低版本微信上会提示兼容问题。本地联调的第一步是打开开发者工具右上角的“详情 → 本地设置”勾选“不校验合法域名”。这个开关不打开wx.request会自动拦截http://localhost:8080页面会一直报url not in domain list。这个配置只对开发环境有效上线发布前必须换成 HTTPS 正式域名。关于“微信小程序顶部导航栏高度”的适配毕设阶段我的建议是用默认导航栏不要用自定义导航栏。自定义导航栏要处理状态栏高度、胶囊位置、机型适配工程量不小对民宿项目这种信息展示类页面没有明显收益。如果做搜索页想加一个吸顶的搜索框通过wx.getSystemInfoSync().statusBarHeight拿状态栏高度然后在这个高度基础上加搜索框自身高度即可不必全局自定义导航栏。4.2 封装 wx.request统一请求头、token 与错误提示小程序里所有页面都会发请求如果不封装每个页面都要写一遍 wx.request 回调更麻烦的是 token 失效、网络异常这些逻辑会在十几个页面里重复实现。我一般建一个 utils/request.js把基础请求统一收口。// utils/request.js const BASE_URL http://localhost:8080/minisu function request({ url, method GET, data {} }) { return new Promise((resolve, reject) { const token wx.getStorageSync(token) wx.request({ url: BASE_URL url, method, data, header: { Content-Type: application/json, Authorization: token ? token : }, success(res) { if (res.statusCode 200) { resolve(res.data) } else if (res.statusCode 401) { wx.removeStorageSync(token) // 登录态过期回到登录页重新授权 wx.navigateTo({ url: /pages/login/login }) reject(res) } else { wx.showToast({ title: 请求失败, icon: none }) reject(res) } }, fail() { wx.showToast({ title: 网络异常, icon: none }) reject(res) } }) }) } module.exports { request }BASE_URL里不能少/minisu这段上下文路径这是项目部署时 Tomcat 里配置的 Application context。method默认 GETdata即使是 GET 请求也会被wx.request自动拼到 query 上。401 的处理必须前置token 过期是所有毕设项目里最容易暴露的逻辑缺口很多项目在 token 过期后不跳登录页页面会一直拿到一个报错对象用户根本不知道发生了什么。4.3 房源列表、搜索与排序参数怎么传给后端 MySQL 查询房源列表页的请求参数后端一般接收 city、keyword、priceMin、priceMax、sort、pageNum、pageSize。前端把页面上的筛选条件拼进 data 里后端在 MyBatis 中用动态 SQL 拼接查询条件。select idselectPage resultTypecom.minisu.entity.House select id, name, address, city, price, cover_img, status from house where if testcity ! null and city ! and city #{city} /if if testkeyword ! null and keyword ! and (name like concat(%, #{keyword}, %) or address like concat(%, #{keyword}, %)) /if if testpriceMax ! null and price lt; #{priceMax} /if and status 1 /where order by choose when testsort price_ascprice asc/when when testsort price_descprice desc/when otherwisecreate_time desc/otherwise /choose limit #{offset}, #{pageSize} /selectwhere标签会自动去掉第一个 and这个特性很多人不知道但它是 MyBatis 动态 SQL 的招牌功能。价格排序的sort字段有两层含义前端传price_asc或price_desc后端把它映射到order bylimit里的offset是前端传的(pageNum - 1) × pageSize不要在后端用pageNum × pageSize否则第二页起就会漏数据。排序这种活儿放到 MySQL 里做数据量一大效率优势就很明显小程序端拿到结果直接渲染就行。4.4 下单与模拟支付订单状态机如何流转民宿项目的订单状态机是答辩时的核心亮点待支付 → 待入住 → 已入住 → 已完成取消操作从待支付或待入住状态发起。前端从房源详情页跳确认订单页用户选入住和退房日期前端按每晚价格乘天数算出 total_price调/api/booking/create生成订单。生成订单后不直接支付而是进到订单确认页展示订单号、价格明细、房东信息用户点“确认支付”时再调支付接口。毕业设计阶段最稳妥的是做模拟支付因为真实微信支付需要商户号和企业资质个人开发者没有开通条件。模拟支付在后端写一个接口把订单号对应的状态从 0 改成 1再记录支付时间前端收到成功回调后跳转到订单列表页。PostMapping(/api/booking/pay) ResponseBody public Result pay(RequestBody PayRequest req) { // 模拟支付不调微信支付 SDK只改订单状态 Booking booking bookingService.getByOrderNo(req.getOrderNo()); if (booking null) return Result.error(订单不存在); if (booking.getStatus() ! 0) return Result.error(订单状态不允许支付); bookingService.updateStatus(req.getOrderNo(), 1); return Result.ok(); }模拟支付的接口虽然简单但状态校验不能省。status ! 0时直接报错防止用户对同一订单重复支付。答辩时如果评委问“模拟支付和真实支付的区别”可以说真实支付需要额外拼接签名、调微信统一下单接口、处理回调验签模拟支付只保留了业务侧的状态流转把支付渠道逻辑替换成了本地状态修改。这个回答既诚实又展示了你理解两者的边界。5. 联调避坑手册SSM MySQL 小程序最常见的 5 个翻车现场这一段是我最想写的部分。联调期 80% 的时间花在这些“不是 bug 的 bug”上。每一条我都按现象、原因、解决三步记录对照着查能省一晚上。5.1 小程序请求 404url 路径和后端 RequestMapping 对不上现象小程序端wx.request报fail url not foundNetwork 面板里请求是红色 404。 原因最常见的是BASE_URL少了上下文路径/minisu或者后端RequestMapping里写的是/house/list而前端请求的是/api/house/list。另一个隐蔽的原因是部署时 war 包名变了Tomcat 自动生成的上下文路径不是/minisu。 解决先在后端 Controller 里加一行日志打印request.getRequestURI()看请求实际到达的地址再对比前端的 url 拼接规则。不要凭猜改代码日志里的真实路径最靠谱。5.2 中文乱码Tomcat URI 编码和 MySQL 连接参数不一致现象房源名称在数据库里显示正常小程序里却显示一串问号或者后端返回 JSON 里中文完好但页面渲染成乱码。 原因至少有三处编码要一致——Tomcat 默认 URI 编码是 ISO-8859-1如果前端 GET 请求带中文参数Tomcat 解析不到 UTF-8MySQL 表字符集如果是 latin1写入时就已乱码Spring 的 CharacterEncodingFilter 没配置时POST 请求体中文也会乱。 解决在项目的web.xml里配CharacterEncodingFilterforceEncoding 设为 true连接 url 带上characterEncodingutf8建表统一 utf8mb4。这三层都对齐后乱码问题基本绝迹。5.3 数据库连接超时MySQL 8 和 5.7 的驱动差异现象Tomcat 能启动但第一个请求卡住十几秒然后报Communications link failure后续请求全部失败。 原因装了 MySQL 8.0 却还在用老驱动com.mysql.jdbc.DriverMySQL 8 的认证插件是 caching_sha2_password老驱动不认识。另外 MySQL 8 要求 timezone 明确不配serverTimezone也会在连接建立时失败。 解决如果坚持用 MySQL 8把驱动改为com.mysql.cj.jdbc.Driver并在 url 加serverTimezoneAsia/Shanghai图省事就卸载 8.0 换 5.75.7 的认证方式和老驱动兼容。两种办法我都试过从零搭环境的话后者更顺手。5.4 图片上传后加载不出来Tomcat 虚拟路径没映射现象房东后台上传房源图片接口返回成功但小程序端图片标签显示空白直接在浏览器里访问图片地址也是 404。 原因图片被保存到了项目的临时目录或 Tomcat 之外的磁盘路径。如果写在 webapps 下每次重新部署项目上传的图片会随旧 war 包一起被清除如果写在 D:/uploadsTomcat 默认访问不到这个路径。 解决在 Tomcat 的server.xml的 Host 节点下加一个 Context 映射把/upload虚拟路径指向磁盘真实目录同时把图片保存路径从代码里抽出来配成常量不要散落在 Controller 各处。不配这个映射今天能看、明天重启就丢的图片会让你十分被动。5.5 手机号登录没权限企业主体、测试号和毕设替代方案现象点击“微信一键登录获取手机号”按钮回调里返回getPhoneNumber:fail no permission后端 code 换手机号接口也无数据。 原因微信小程序的getPhoneNumber能力从基础库 2.21.2 起要求小程序必须完成微信认证且仅支持企业、个体户等非个人主体个人主体和测试号拿不到该能力。 解决毕设项目通常分两步走——登录主流程用wx.login拿 code 换 openid 作为用户唯一标识再配一个独立的手机号输入框让用户手动填写作为账号绑定的联系方式。答辩时如果被问到直接说“获取手机号能力受个人主体限制此处使用授权 code 登录 手动手机号绑定来模拟”这是行业内的通行做法。6. 答辩前验证清单从“能跑通”到“能讲清楚”的三步收尾答辩那一周我通常会花半天做一次完整的“演示彩排”而不是继续写新功能。因为新功能的需求永远做不完演示流程一旦中断评委印象分会很受影响。我建议你固定一个演示脚本用测试账号登录 → 搜索“杭州”房源 → 按价格排序 → 进入详情 → 选择日期 → 下单 → 模拟支付 → 查看订单状态 → 去留言评价 → 在“我的”页面看到评价记录。每一步控制在 10 秒内整个流程 3 分钟讲完。彩排时要顺手清掉脏数据把之前测试的已取消订单、重复评价删掉或重置保证每次演示起点一致。数据库里留几条状态不干净的数据评委点开订单列表时很容易分心。最后两步我习惯做一次“前后端边界自查”。打开小程序 Network 面板逐个看请求的 status code200 正常401 说明 token 逻辑要再过一遍500 就要去翻 IDEA 控制台里的完整堆栈只看到红色报错信息是不够的滚动到Caused by那一行才是根因。这个排查习惯不仅答辩前用后面做任何 Web 项目都用得上。论文里对应放一张系统架构图和一张订单状态流程图图里的模块名和代码里的包名保持一致不要图上一套代码一套评委一眼就能看出来。说起来很直白我的经验是任何一个功能点如果你不能一口气说出“数据从哪个页面来、经过哪个接口、存在哪张表、返回什么结构”说明还没真正掌握它。把它补清楚再去答辩你的自信程度是完全不同的。希望帮到你。本文还有配套的精品资源点击获取