夜雨聆风学习资料网

ARTICLE · 1367117

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

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

00 导语:民宿系统真正的难点,是房态和订单不能各说各话

做民宿、酒店、公寓这类住宿生意,线上化最先撞上的不是流量问题,而是"同一间房卖了几次"。前台用表格记房态、OTA 后台改价格、微信里收定金,三个地方各存一份数据,旺季一超卖,处理退款和差评的成本比多卖一间房高得多。

这套 JAVA 民宿酒店线上预约系统把这条链路收成一条:房源与房型在后台维护,价格日历和房态库存按天独立配置,用户端按城市、日期、房型筛选并在线选房下单,订单状态在后台流转,入住完成后可申请电子发票。服务端是 Spring Boot + MyBatis-Plus + MySQL 的常规 Java 分层架构,用户端用 uni-app(Vue 语法)一套代码同时输出小程序、公众号、APP 与 H5。

下面按"找房—看房—下单—入住—开票"的顺序逐项拆功能,再给三端分工、核心表结构和几段可以直接落地的代码。文中截图均为演示环境数据,手机号、姓名与地址已做脱敏处理。

01 功能总览:6 个模块覆盖一整套住宿经营动作

先铺开地图。6 个功能模块分别对应"卖什么、怎么找、怎么下单、怎么优惠、怎么开票、谁在管",每一格后面都有一节详细拆解。

房源管理
房型 · 图片 · 设施 · 价格日历把一间房拆成"可售单元 + 按天库存",是后面所有功能的数据底座。
精准分类
国内 · 钟点房 · 民居按城市、日期、业态筛选,让用户三步内看到能订的房。
订单管理
确认 · 支付 · 入住 · 完成状态机统一在一处流转,改退、超时释放都走同一条通道。
优惠券管理
满减 · 折扣 · 新人券券模板与发放记录分离,运营发券不用改代码。
发票管理
开票申请 · 开票记录按订单金额与税号开票,抬头信息可复用。
商家中心
房源维护 · 订单处理 · 结算一个商家一套数据,后台按 merchant_id 隔离。

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 技术架构:三端各管一段,边界写清楚

三端职责如果划不清,最后会变成"什么都在后台判、什么都在前端算"。这套系统的划分是:用户端只负责展示与采集,管理后台只负责配置与审核,所有价格、库存、状态、权限的判断都在服务端完成。

端
负责什么 · 边界在哪
用户端uni-app(Vue 语法)
找房、看详情、下单、支付、订单与发票入口。边界:不算价、不判库存、不拼查询条件。
管理后台Vue + ElementUI
房源与房型维护、价格日历、订单处理、券模板、开票与结算。边界:不直接改订单金额与状态,只发起动作。
服务端Spring Boot + MyBatis-Plus + MySQL
鉴权、价格计算、库存扣减、状态机、幂等、对账。边界:不关心端上怎么画,只保证数据一致。

08 数据库与核心代码

下面 7 段按"表结构 → 下单事务 → 房态扣减 → 幂等 → 商家隔离 → 多端请求 → 后台表格"组织。订单状态统一用 10/20/30/40/50,字段名前后一致,改代码时不用再猜语义。

1. 房源、房态与订单的核心表

先定表。room_type 是可售单元,room_stock 按天存库存与价格,order 用版本号做乐观锁,invoice 挂在订单下。

SQL
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. 下单:事务里同时锁库存、核券、建单

三个动作必须同进同退:扣房态、核销券、写订单。异常直接抛出,交给事务回滚。

JAVA
@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 就代表抢完了,天然防超卖。

JAVA
@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,重试不会重复下单;唯一索引是最后一道闸。

JAVA
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 就查到别人的房。

JAVA
@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、端标识和错误码处理。

JAVASCRIPT
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 的表格与分页组合,上下架走同一个接口改状态,列表即时刷新。

VUE
<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 做一套可二开的住宿预订系统,欢迎找我领取演示资料和部署说明。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料