ARTICLE · 1367117
JAVA民宿酒店线上预约系统源码支持小程序+公众号+H5

00 导语:民宿系统真正的难点,是房态和订单不能各说各话
做民宿、酒店、公寓这类住宿生意,线上化最先撞上的不是流量问题,而是"同一间房卖了几次"。前台用表格记房态、OTA 后台改价格、微信里收定金,三个地方各存一份数据,旺季一超卖,处理退款和差评的成本比多卖一间房高得多。
这套 JAVA 民宿酒店线上预约系统把这条链路收成一条:房源与房型在后台维护,价格日历和房态库存按天独立配置,用户端按城市、日期、房型筛选并在线选房下单,订单状态在后台流转,入住完成后可申请电子发票。服务端是 Spring Boot + MyBatis-Plus + MySQL 的常规 Java 分层架构,用户端用 uni-app(Vue 语法)一套代码同时输出小程序、公众号、APP 与 H5。
下面按"找房—看房—下单—入住—开票"的顺序逐项拆功能,再给三端分工、核心表结构和几段可以直接落地的代码。文中截图均为演示环境数据,手机号、姓名与地址已做脱敏处理。
01 功能总览:6 个模块覆盖一整套住宿经营动作
先铺开地图。6 个功能模块分别对应"卖什么、怎么找、怎么下单、怎么优惠、怎么开票、谁在管",每一格后面都有一节详细拆解。
| 房源管理 | 精准分类 |
| 订单管理 | 优惠券管理 |
| 发票管理 | 商家中心 |
02 房源管理与精准分类:先让房能卖,再让用户找得到
房源管理
输入:商家在后台录入房源基本信息(名称、城市、商圈、地址、图片、设施标签),再按房型拆出可售单元,例如"大床房 / 双床房 / 家庭房",每个房型挂自己的价格与库存。输出:用户端可见的房源列表、详情页与房型卡片。状态:草稿、上架、下架、满房。
这里有个容易做错的点:库存不能挂在房型上,必须按日期挂。同一间大床房,7 月 20 日有 3 间、21 日只剩 1 间,如果用"房型.库存"一个字段,就只能按最低值卖,白白少卖两晚。正确做法是一张"房型 × 日期"的日历表,每行是一个可售日,扣减时对这一行做条件更新。
精准分类
用户端顶部是业态切换(国内 / 钟点房 / 民居),下面是城市定位、入住与离店日期、关键词搜索,再往下是热门推荐与按价格、评分、距离排序的列表。筛选条件全部由服务端拼查询,前端只传结构化参数,不拼 SQL 片段。
分类与筛选的组合要控制住索引:城市 + 入住日期 + 业态是最常用的三件套,给 (city_id, biz_type, check_in) 建联合索引,列表页就能稳定走索引而不是全表扫。日期区间查询用"日历表里存在该区间内的可售行"来判断,避免在订单表上做范围统计。

【JAVA民宿酒店线上预约系统】实拍 01|首页城市定位与「国内 / 钟点房 / 民居」业态入口、订单列表的待付款与待入住分组、会员中心的优惠券与足迹入口;截图数据为演示数据
03 房源详情与房型价格:把"能不能订"讲清楚
详情页承担三件事:让用户确认位置与环境(图片、地址、设施标签)、确认价格(房型卡片上的单晚价与总价)、确认可订(房型右侧的"预订"按钮是否可点)。三件事缺一件,用户就会跳出去比价。
价格计算建议放在服务端做:房型基准价 × 日期系数(平日 / 周末 / 节假日)× 会员折扣- 优惠券,最后返回每晚明细和合计。前端只展示,不参与计算,否则一旦有活动价,客户端算出来的金额和支付金额对不上,投诉就来了。
设施标签(免费停车、免费 WiFi、含早餐、可做饭)用多选字典维护,既能做详情页展示,也能在列表页做筛选项,一套数据两处用。房型图按宽高比统一裁剪,避免用户端列表出现高低不齐的卡片。
04 订单管理:状态机只有一条主线
下单流程:选房型与日期 → 填入住人信息 → 确认订单(房费、清洁费、优惠、应付)→ 支付 → 生成订单 → 到店入住 → 完成。中间任何一步失败,都要能回到"未占用库存"的状态。
订单状态建议只用五个值:10 待付款 / 20 待入住 / 30 已入住 / 40 已完成 / 50 已取消。所有业务动作(支付回调、超时关单、商家确认、用户取消、退款)都只做状态迁移,不在业务代码里散落"if 状态等于…"。状态迁移表写在一处,出了纠纷能一眼查清是谁改的。
超时未支付要有兜底:下单时占库存,15 分钟没付款就释放。释放动作做成定时任务扫描 + 支付回调双重保障,任何一边漏了,另一边还能兜住。

【JAVA民宿酒店线上预约系统】实拍 02|订单详情页的状态与金额明细、按日期筛选的酒店列表、酒店详情页的房型卡片与价格;截图数据为演示数据
05 优惠券管理:券模板和发放记录分开存
券要做成三层:券模板(满减 / 折扣 / 立减,门槛、面额、有效期、适用房源)、发放记录(发给谁、什么时候发、来源是新人礼还是活动)、核销记录(哪笔订单用掉的)。三层分开,运营就能做到"同一张券发给不同人群、各自算各自的预算"。
核销必须和下单在同一个事务里:锁券 → 校验可用 → 标记已用 → 建单,任何一步失败整笔回滚。用券金额要在订单上落一份快照,否则券模板被改过一次,历史订单的优惠金额就变了,对账永远对不平。
会员中心里同时展示优惠券、收藏和足迹,这三块是提升复购最直接的位置:用户打开"我的"看到有 3 张券快过期,比推送十条消息都有效。
06 发票管理与商家中心:把经营侧的动作收进后台
发票管理
开票入口挂在订单完成后:用户选订单 → 填抬头(个人 / 企业,企业要税号)→ 提交申请 → 后台开具 → 记录里可查。抬头信息保存成常用抬头,第二次开票不用重新填。
金额要按实付开,不按房费原价开;一个订单可以拆多张票(例如公司报销分部门),但合计不能超过实付金额。开票记录建议保留操作人与时间,税务核查时这些字段比发票号本身更有说服力。
商家中心
商家中心是给房东和店长用的:维护房源与房型、改价格日历、处理订单(确认、拒单、标记入住)、查看结算流水。所有查询都必须带 merchant_id 条件,而这个 id 只能从登录态里取,不能接受前端传参——这是住宿类系统最常见的越权入口。

【JAVA民宿酒店线上预约系统】实拍 03|酒店详情页的活动位与房型价格、确认订单页的入住人与费用明细、开票服务的申请与记录入口;截图数据为演示数据
07 技术架构:三端各管一段,边界写清楚
三端职责如果划不清,最后会变成"什么都在后台判、什么都在前端算"。这套系统的划分是:用户端只负责展示与采集,管理后台只负责配置与审核,所有价格、库存、状态、权限的判断都在服务端完成。
08 数据库与核心代码
下面 7 段按"表结构 → 下单事务 → 房态扣减 → 幂等 → 商家隔离 → 多端请求 → 后台表格"组织。订单状态统一用 10/20/30/40/50,字段名前后一致,改代码时不用再猜语义。
1. 房源、房态与订单的核心表
先定表。room_type 是可售单元,room_stock 按天存库存与价格,order 用版本号做乐观锁,invoice 挂在订单下。
CREATE TABLE `room_type` ( `id` BIGINT NOT NULL AUTO_INCREMENT, `merchant_id` BIGINT NOT NULL COMMENT '商家,数据隔离键', `hotel_id` BIGINT NOT NULL COMMENT '所属房源', `name` VARCHAR(64) NOT NULL COMMENT '大床房 / 双床房 / 家庭房', `base_price` DECIMAL(10,2) NOT NULL COMMENT '基准价,元/晚', `facilities` VARCHAR(255) NULL COMMENT '设施标签,逗号分隔', `status` TINYINT NOT NULL DEFAULT 1 COMMENT '1上架 0下架', PRIMARY KEY (`id`), KEY `idx_hotel` (`hotel_id`, `status`)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;CREATE TABLE `room_stock` ( `id` BIGINT NOT NULL AUTO_INCREMENT, `room_type_id` BIGINT NOT NULL, `biz_date` DATE NOT NULL COMMENT '可售日期', `price` DECIMAL(10,2) NOT NULL COMMENT '当日价', `stock` INT NOT NULL DEFAULT 0 COMMENT '剩余可售', `version` INT NOT NULL DEFAULT 0 COMMENT '乐观锁', PRIMARY KEY (`id`), UNIQUE KEY `uk_type_date` (`room_type_id`, `biz_date`), KEY `idx_date` (`biz_date`)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;CREATE TABLE `hotel_order` ( `id` BIGINT NOT NULL AUTO_INCREMENT, `order_no` VARCHAR(32) NOT NULL, `user_id` BIGINT NOT NULL, `merchant_id` BIGINT NOT NULL, `room_type_id` BIGINT NOT NULL, `check_in` DATE NOT NULL, `check_out` DATE NOT NULL, `nights` INT NOT NULL, `amount` DECIMAL(10,2) NOT NULL COMMENT '实付', `status` TINYINT NOT NULL COMMENT '10待付款 20待入住 30已入住', `request_id` VARCHAR(64) NOT NULL COMMENT '幂等键', `version` INT NOT NULL DEFAULT 0, PRIMARY KEY (`id`), UNIQUE KEY `uk_no` (`order_no`), UNIQUE KEY `uk_request` (`request_id`), KEY `idx_user` (`user_id`, `status`)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; |
2. 下单:事务里同时锁库存、核券、建单
三个动作必须同进同退:扣房态、核销券、写订单。异常直接抛出,交给事务回滚。
@Transactional(rollbackFor = Exception.class)public OrderVO create(CreateOrderCmd cmd) { String key = cmd.getRequestId(); OrderVO old = orderMapper.selectByRequestId(key); if (old != null) { return old; // 幂等:同一个请求直接返回 } int nights = DateUtil.betweenDays(cmd.getCheckIn(), cmd.getCheckOut()); if (nights <= 0) { throw new BizException("离店日期必须晚于入住日期"); } // 1. 逐日扣库存,任何一天不足就整笔失败 LocalDate d = cmd.getCheckIn(); while (d.isBefore(cmd.getCheckOut())) { int n = stockMapper.deduct(cmd.getRoomTypeId(), d); if (n == 0) { throw new BizException("房型已满:" + d); } d = d.plusDays(1); } // 2. 核销优惠券(条件更新,已用则影响行数为 0) if (cmd.getCouponId() != null) { int n = couponMapper.use(cmd.getCouponId(), cmd.getUserId()); if (n == 0) { throw new BizException("优惠券不可用"); } } // 3. 落订单,金额由服务端按日历价重算 HotelOrder o = OrderAssembler.build(cmd, nights); o.setRequestId(key); o.setStatus(10); orderMapper.insert(o); return OrderVO.of(o);} |
3. 房态扣减:条件更新就是最轻的锁
不查再改,直接 UPDATE ... WHERE stock > 0,影响行数为 0 就代表抢完了,天然防超卖。
@Update("UPDATE room_stock SET stock = stock - 1, version = version + 1 " + "WHERE room_type_id = #{typeId} AND biz_date = #{date} " + "AND stock > 0 AND version = #{version}")int deductWithVersion(@Param("typeId") Long typeId, @Param("date") LocalDate date, @Param("version") Integer version);// 不需要 client 传版本号时,用无版本的条件更新即可@Update("UPDATE room_stock SET stock = stock - 1 " + "WHERE room_type_id = #{typeId} AND biz_date = #{date} AND stock > 0")int deduct(@Param("typeId") Long typeId, @Param("date") LocalDate date); |
4. 幂等:requestId 唯一索引兜底
前端每次提交带同一个 requestId,重试不会重复下单;唯一索引是最后一道闸。
public OrderVO submit(CreateOrderCmd cmd) { String key = cmd.getRequestId(); try { return orderService.create(cmd); // 内部先查 requestId } catch (DuplicateKeyException e) { HotelOrder o = orderMapper.byRequestId(key); if (o == null) { throw new BizException("重复提交,请稍后重试"); } return OrderVO.of(o); // 并发撞车,返回已有订单 }} |
5. 商家数据隔离:merchantId 只从登录态取
后台每个查询都强制带 merchant_id,不接受前端传参,避免改个 id 就查到别人的房。
@GetMapping("/merchant/room/page")public Page<RoomVO> page(RoomQuery q) { Long merchantId = AuthContext.current().getMerchantId(); if (merchantId == null) { throw new BizException("非商家账号"); } q.setMerchantId(merchantId); // 强制覆盖,忽略前端传的值 return roomService.page(q);}// 单条查询也要带条件,不能只按 id@Select("SELECT * FROM room_type WHERE id = #{id} AND merchant_id = #{merchantId}")RoomType selectOwned(@Param("id") Long id, @Param("merchantId") Long merchantId); |
6. 多端请求:一套封装覆盖四端
小程序、公众号 H5、APP 共用一层 request,统一带 token、端标识和错误码处理。
const BASE = 'https://api.example.com';function request(path, options = {}) { const token = uni.getStorageSync('token'); return new Promise((resolve, reject) => { uni.request({ url: BASE + path, method: options.method || 'GET', data: options.data || {}, header: { 'content-type': 'application/json', 'X-Client': uni.getSystemInfoSync().uniPlatform, 'Authorization': token ? 'Bearer ' + token : '' }, success(res) { const body = res.data || {}; if (res.statusCode === 401) { uni.reLaunch({ url: '/pages/login/index' }); return reject(body); } if (body.code !== 0) { uni.showToast({ title: body.msg || '请求失败', icon: 'none' }); return reject(body); } resolve(body.data); }, fail(err) { reject(err); } }); });}export default request; |
7. 后台房源表格:分页 + 上下架
ElementUI 的表格与分页组合,上下架走同一个接口改状态,列表即时刷新。
<template> <el-table :data="rows" v-loading="loading" border size="small"> <el-table-column prop="name" label="房型" min-width="140" /> <el-table-column prop="hotelName" label="房源" min-width="160" /> <el-table-column prop="basePrice" label="基准价" width="100"> <template #default="{ row }">¥{{ row.basePrice }}</template> </el-table-column> <el-table-column label="状态" width="90"> <template #default="{ row }"> <el-tag :type="row.status === 1 ? 'success' : 'info'"> {{ row.status === 1 ? '上架' : '下架' }} </el-tag> </template> </el-table-column> <el-table-column label="操作" width="120"> <template #default="{ row }"> <el-button link type="primary" @click="toggle(row)"> {{ row.status === 1 ? '下架' : '上架' }} </el-button> </template> </el-table-column> </el-table> <el-pagination background layout="prev, pager, next, total" :total="total" :page-size="query.size" @current-change="onPage" /></template> |
09 合规与上线检查:住宿类系统绕不开的六件事
住宿业务涉及实名、资金、发票和个人信息,下面六项不是"锦上添花",而是上线前必须落地的部分。具体口径以当地监管与平台规则为准。
工程侧的检查清单:下单与支付回调都做幂等;库存扣减用条件更新;超时未支付自动释放;后台所有查询带 merchant_id;金额字段统一 DECIMAL 不用 float;导出与日志脱敏。
10 适合谁
第一类:有 5–50 间房的民宿、公寓、客栈老板。现在靠 OTA 和微信接单,想有一套自己的预订页,把老客沉淀下来,顺便把发票和入住登记电子化。
第二类:做本地生活或文旅的小团队。手里有房源资源但没有系统,需要一个能二开的底座,接上自己的支付、短信和小程序主体。
第三类:软件公司做项目交付。需要一套结构清晰、表设计合理的住宿类系统作为起点,在它上面加区域运营、连锁管理或分销。
第四类:想从"接单工具"升级成"经营系统"的商家。已经能收单,但价格日历、优惠券、发票各在一处,需要一个统一后台。
11 常见问题
Q1:能只要用户端、不要后台吗?不建议。房源、房态、价格日历都在后台维护,只有用户端就没有可卖的数据;如果只想先上一个预订页,至少要把房源与房态两块后台带上。
Q2:支持多商家、多门店吗?表结构里 merchant_id 是数据隔离键,多商家天然支持;多门店在同一商家下再加一层 hotel 维度即可,列表与库存都按 hotel 过滤。
Q3:房态和 OTA 怎么同步?建议做单向主数据:以本系统为准,通过渠道接口把库存与价格推给 OTA;反向拉单走订单同步任务,两边都用外部单号做幂等。
Q4:小程序、公众号、APP、H5 要维护四套代码吗?不用。用户端是 uni-app 一套代码,按平台条件编译差异部分(登录、支付、分享),其余页面共用。
Q5:能改成钟点房、日租、长租吗?能。房态表是按天的,钟点房再加一个时段维度(start_time / end_time)即可;长租把按天扣减换成按周期占用。
Q6:交付包含什么?源码、数据库脚本、部署说明与接口文档;二开按模块报价,支付与短信需要你自己的商户号与签名。
12 结语
住宿类系统的价值不在页面多好看,而在于"同一间房不会被卖两次、每一笔钱都能对上、每一张票都开得出来"。这套结构把房源、房态、订单、发票串成一条链,剩下的连锁管理、分销、智能定价,都是在同一套骨架上做加法。
如果你正在做民宿、酒店或公寓的线上预订,或者想基于 Spring Boot + uni-app 做一套可二开的住宿预订系统,欢迎找我领取演示资料和部署说明。















































































