Java Swing+MySQL酒店管理系统开发全攻略

七八年前我第一次做酒店管理系统，用的就是 Java Swing + MySQL。当时没什么架构概念，idea 也是同学帮忙配的，唯一的目标是让系统能在某个地方跑起来。后来帮别人改过几套同类系统，也带过零基础的朋友从建表一路做到答辩演示，慢慢发现这个选题看着简单，实际要做好，讲究比想象中多。这篇想用我这些年反复踩过的坑和沉淀下来的做法，把 Java swing mysql 实现的酒店管理系统从头到尾讲透：业务怎么拆、表怎么建、代码怎么写、坑怎么避、项目怎么交付。零基础看完不敢说直接精通，但照着手敲一遍，自己独立改动和讲清楚设计逻辑，问题不大。

1. 酒店管理系统到底在管什么：先把业务拆开

很多人一上来就写代码，写着写着发现功能散成一堆窗口，就是因为没先想清楚“酒店前台到底在干什么”。所以我建议先别碰工程，花半天时间把业务流程画出来。

1.1 前台的一天是怎么转的

可以把前台一天的工作想象成一条流水线：客人到店，先看房型、问房价，然后选房间；选好后登记身份信息、交押金、拿到房卡，系统里这间房就从“空闲”变成“已入住”；住店期间可能会换房、加床、续住；退房时结算房费和其他消费，房间状态变成“打扫中”；保洁完成后再改回“空闲”，等待下一单。

这个流程里最关键的是“房态”和“订单”。房态是房间的实时状态，订单是客人和房间之间的关系。很多初学者把这两个东西混在一起，导致界面显示乱了、账也算错。我的建议是：数据库里专门维护房间状态字段，同时每个订单记录入住时间和退房时间，所有界面上的“现在有几间空房”都靠实时查询，不靠手工改。

1.2 从功能清单反推系统模块

如果不想做需求文档，至少列一张功能清单。一个能交给别人验收的酒店管理系统，通常包含这些模块：

这个清单其实是很好的“骨架”。每个模块对应一组窗口和一组 DAO 方法，写代码的时候按照模块推进，不容易乱。

1.3 为什么这个组合至今没被淘汰

近几年我在不同场合见过这个组合被吐槽“技术老”“界面丑”，但现实中它依然大量存在。原因很简单：酒店前台用到的功能基本固定在局域网内，数据量不大，界面样式要求不高，而且很多中小型酒店不具备部署 Web 服务的 IT 人员。Java Swing 打包成桌面程序，双击就能跑，MySQL 负责数据存储，维护成本低，特别适合毕业设计、课程设计和小企业自用。我更愿意把它理解成“够用且可控的工具组合”。

2. 技术选型反思：桌面端 + 本地 MySQL，真的过时了吗

每次有人问我“为什么不用 Spring Boot 写一个管理系统”，我都先反问一句：你的部署环境是什么样的？没有服务器的前提下，桌面程序反而比 Web 系统更简单。

2.1 Swing 的“老”和“稳”并不矛盾

Swing 从 1997 年诞生到现在，界面风格确实不如新框架漂亮，但它胜在稳定和直观。它属于 Java SE 自带的一部分，不用额外引入第三方框架，生命周期管理由 JVM 负责，只要 JDK 能跑，界面就能跑。对零基础来说，Swing 的组件模型也足够简单：窗口是 JFrame，面板是 JPanel，按钮是 JButton，文本框是 JTextField，表格是 JTable，这套东西学一天就能上手。

不要一上来就纠结 Swing 被某些书说成“过时”。我见过用 Swing 写的内部 ERP 系统稳定运行七八年，也见过华丽的新框架项目上线三个月没人维护。技术选型看场景，不看流行程度。

2.2 数据库为什么选 MySQL 而不是 SQLite / 云端

酒店管理系统需要考虑多人同时操作，SQLite 虽然单机部署方便，但并发写入能力弱，数据完整性也差一些。MySQL 在本地或者局域网服务器上安装都很容易，支持事务，支持多表关联查询，备份恢复资料也多，对这种规模的应用来说是典型“杀鸡用牛刀，但用着踏实”。

如果真遇到只有一台电脑的情况，MySQL 也可以直接装在同一台机器上，连接地址写 localhost，不影响使用。我的建议是始终把连接地址这类配置集中在一个工具类里，以后要迁移到局域网服务器，改一个 IP 就够了。

2.3 环境准备和依赖清单

这套系统跑起来需要的环境有：JDK 8 或更高版本、MySQL 5.7 或 8.0、MySQL 的 JDBC 驱动包 mysql-connector-java。JDK 我用得最多的是 8，稳定且兼容旧电脑；MySQL 8.0 连接 URL 里要加时区配置，具体写法我在后面第 6 章会专门讲。

IDE 没有硬性要求，用顺手的就行。我在本地新建项目时通常把驱动 jar 放到项目根目录下的 lib 文件夹，再在项目设置里把它加入依赖，这样打包的时候能一并处理。

3. 数据库设计：能不能扛住真实业务，全看这几张表

我见过太多失败项目是写到一半发现表结构不对，然后代码和数据库来回改，最后数据库被改得面目全非。所以表设计哪怕多花三天也值。

3.1 实体关系：办一次入住牵动了多少数据

一次入住动作其实牵扯了至少四个实体：客人、房间、房型、订单。客人可能多次入住，所以客人信息和订单信息要分开；房间属于某个房型，房型决定基础房价；订单关联到具体的客人和具体的房间。还有一个用户实体，用来控制谁能登录系统。

给零基础一个建议：不要把所有字段塞进一张表。比如把“房间号”和“房型价格”放同一张表，表面看省事，实际会带来大量冗余。房型一涨价，你要去更新每一行房间数据，很容易出错。

3.2 建表 SQL：开单即用版本

下面是项目里最常用的建表 SQL，数据库名我用 hotel_ms。密码字段以安全为出发点，正式系统应该存密文，后续代码里我会演示简单做法。

CREATE DATABASE hotel_ms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE hotel_ms; CREATE TABLE admin_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, real_name VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE room_type ( id INT PRIMARY KEY AUTO_INCREMENT, type_name VARCHAR(50) NOT NULL, price DECIMAL(10,2) NOT NULL, bed_info VARCHAR(100), area INT, remark VARCHAR(255) ); CREATE TABLE room ( id INT PRIMARY KEY AUTO_INCREMENT, room_no VARCHAR(10) NOT NULL UNIQUE, type_id INT NOT NULL, floor INT, status TINYINT DEFAULT 0, remark VARCHAR(255), FOREIGN KEY (type_id) REFERENCES room_type(id) ); CREATE TABLE customer ( id INT PRIMARY KEY AUTO_INCREMENT, id_card VARCHAR(30) NOT NULL, name VARCHAR(50) NOT NULL, phone VARCHAR(20), vip_level INT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE checkin_order ( id INT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL UNIQUE, customer_id INT NOT NULL, room_id INT NOT NULL, checkin_time DATETIME NOT NULL, expect_time DATETIME, checkout_time DATETIME, deposit DECIMAL(10,2) DEFAULT 0, total_amount DECIMAL(10,2) DEFAULT 0, status TINYINT DEFAULT 0, operator VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (customer_id) REFERENCES customer(id), FOREIGN KEY (room_id) REFERENCES room(id) );

房间表的 status 我用 0 表示空闲，1 表示已预订，2 表示已入住，3 表示打扫中。订单表的 status 用 0 表示入住中，1 表示已退房，2 表示已取消。这种数字枚举写进代码里后，最好再配一个常量类，避免到处写魔法数字。

3.3 金额、状态、时间的字段规范

金额一定要用 DECIMAL，不要用 DOUBLE 或 FLOAT。因为浮点数存的是近似值，计算几次累计误差就出来了，对账的时候非常难看。房费这种核心字段我习惯用 DECIMAL(10,2)，足够覆盖大多数酒店的价格范围。

时间字段统一用 DATETIME，不要只存日期不存时间。原因很实际：退房按“天”收费，但入住时间直接影响是否算半天房费。把时间存全，后面用 SQL 还是 Java 计算都有依据。

4. 项目骨架：包结构、JDBC 工具类和 Swing 启动方式

表设计完成后，我不会立刻写界面。先搭工程骨架，把数据库连接方法跑通，再接界面，这样每一步出错都能立刻定位到是数据库问题还是界面问题。

4.1 分层包结构到底分给谁看

给零基础推荐一个简单的分层包结构：

com.hotelms.entity // 实体类，对应数据库表 com.hotelms.dao // 数据访问层，操作数据库 com.hotelms.service // 业务层，处理逻辑和事务 com.hotelms.ui // 窗口界面 com.hotelms.util // 工具类，比如数据库连接、日期计算

实体类可以手写，也可以用 IDE 生成。每个表对应一个 JavaBean，字段类型与数据库类型对应，金额用 BigDecimal，时间用 LocalDateTime。分层不是多此一举，而是让代码可以被复核。界面负责展示，业务层负责计算，DAO 只负责 SQL，出了问题直接去对应层找。

4.2 JDBC 工具类：连接别裸写

我要求自己项目里所有 JDBC 连接都走同一个工具类，避免十个窗口各写一套连接逻辑。下面是一个基础版：

package com.hotelms.util; import java.sql.*; public class DBUtil { private static final String URL = "jdbc:mysql://localhost:3306/hotel_ms" + "?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai"; private static final String USER = "root"; private static final String PASS = "123456"; static { try { Class.forName("com.mysql.cj.jdbc.Driver"); } catch (ClassNotFoundException e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASS); } public static void closeAll(ResultSet rs, Statement stmt, Connection conn) { if (rs != null) { try { rs.close(); } catch (SQLException e) { } } if (stmt != null) { try { stmt.close(); } catch (SQLException e) { } } if (conn != null) { try { conn.close(); } catch (SQLException e) { } } } }

注意 URL 里的serverTimezone=Asia/Shanghai和useSSL=false，MySQL 8 下这两个参数基本是标配，不加就会报时区错误。账号密码放在常量里，正式交付时改成从配置文件读，这里先保证能跑。

4.3 Swing 启动方式与事件分发线程

Swing 有个事件分发线程（EDT）。所有界面创建和控件更新都要在 EDT 上执行，否则界面可能闪烁甚至崩溃。Oracle 官方的规范也是通过SwingUtilities.invokeLater启动，工程里main方法不要直接new MainFrame()。

public class App { public static void main(String[] args) { SwingUtilities.invokeLater(() -> new LoginFrame().setVisible(true)); } }

很多教程里直接调用其实也跑得动，但要养成好习惯，因为后面遇到耗时的数据库查询时，你会更需要理解 EDT 机制。

5. 核心功能代码：登录、开单、退房，照着写就能跑

骨架搭好后，挑三个必须实现的核心功能来敲代码：登录、开单入住、退房结账。这三个功能贯穿整个系统，能跑通，剩下的功能基本都是同一套操作模式。

5.1 登录窗口：数据库校验用户

登录逻辑很直接：界面取用户名和密码，查询 admin_user 表，有记录则进入主界面，没有则提示错误。下面是我常用的一种写法。

public class LoginFrame extends JFrame { private JTextField txtUser; private JPasswordField txtPwd; public LoginFrame() { setTitle("酒店管理系统登录"); setSize(360, 220); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setLocationRelativeTo(null); setLayout(null); JLabel lbUser = new JLabel("用户名"); lbUser.setBounds(60, 40, 60, 30); txtUser = new JTextField(); txtUser.setBounds(130, 40, 150, 30); JLabel lbPwd = new JLabel("密码"); lbPwd.setBounds(60, 90, 60, 30); txtPwd = new JPasswordField(); txtPwd.setBounds(130, 90, 150, 30); JButton btnLogin = new JButton("登录"); btnLogin.setBounds(130, 140, 80, 30); add(lbUser); add(txtUser); add(lbPwd); add(txtPwd); add(btnLogin); btnLogin.addActionListener(e -> doLogin()); setVisible(true); } private void doLogin() { String username = txtUser.getText().trim(); String password = new String(txtPwd.getPassword()).trim(); if (username.isEmpty() || password.isEmpty()) { JOptionPane.showMessageDialog(this, "用户名和密码不能为空"); return; } String sql = "SELECT id, real_name FROM admin_user WHERE username=? AND password=?"; try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, username); ps.setString(2, password); try (ResultSet rs = ps.executeQuery()) { if (rs.next()) { int id = rs.getInt("id"); String realName = rs.getString("real_name"); JOptionPane.showMessageDialog(this, "欢迎，" + realName); dispose(); new MainFrame(id, realName).setVisible(true); } else { JOptionPane.showMessageDialog(this, "用户名或密码错误"); } } } catch (SQLException ex) { JOptionPane.showMessageDialog(this, "数据库连接失败：" + ex.getMessage()); } } }

这里用了PreparedStatement而不是拼 SQL 字符串，一是防止 SQL 注入，二是参数写法更清晰。我见过用字符串拼接用户名密码的作业，答辩时被老师问一句就回答不上来，非常可惜。

5.2 主界面：用 JTabbedPane 把模块装进去

主界面我习惯用 JTabbedPane，每个选项卡放一个业务模块。这样做的好处是代码结构清晰，用户切换功能也不用重新开窗口。

public class MainFrame extends JFrame { public MainFrame(int userId, String realName) { setTitle("酒店管理系统 - " + realName); setSize(1000, 700); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setLocationRelativeTo(null); JTabbedPane tab = new JTabbedPane(); tab.addTab("房型管理", new RoomTypePanel()); tab.addTab("房间管理", new RoomPanel()); tab.addTab("客人管理", new CustomerPanel()); tab.addTab("预订入住", new CheckInPanel()); tab.addTab("退房结账", new CheckOutPanel()); tab.addTab("订单查询", new OrderQueryPanel()); tab.addTab("统计报表", new StatisticPanel()); add(tab); } }

实际项目里这些 Panel 类单独写文件。每个 Panel 里通常是一张数据表格加若干个操作按钮，按钮点击后弹出一个录入窗口。这个模式掌握之后，加一个“会员充值”选项卡就是复用一套逻辑的事情。

5.3 开单入住：事务保证房态和订单一致

开单入住是最容易写错的功能，因为它要做三件事：检查房间状态、插入订单记录、更新房间状态。这三件事必须同时成功或同时失败，否则就会出现“订单建了但房间还是空闲”的脏数据。解决办法是开启事务。

public class CheckInService { public boolean checkIn(int roomId, int customerId, BigDecimal deposit, LocalDateTime checkinTime, String operator) { Connection conn = null; try { conn = DBUtil.getConnection(); conn.setAutoCommit(false); // 1. 查看房间当前状态 String querySql = "SELECT status FROM room WHERE id=?"; int status; try (PreparedStatement ps = conn.prepareStatement(querySql)) { ps.setInt(1, roomId); try (ResultSet rs = ps.executeQuery()) { if (!rs.next()) { return false; } status = rs.getInt("status"); } } if (status != 0 && status != 3) { return false; // 只有空闲或打扫完成才能入住 } // 2. 生成订单号并插入订单 String orderNo = LocalDateTime.now() .format(DateTimeFormatter.ofPattern("yyyyMMddHHmmssSSS")); String insertSql = "INSERT INTO checkin_order(order_no, customer_id, room_id," + " checkin_time, deposit, status, operator) VALUES(?,?,?,?,?,0,?)"; try (PreparedStatement ps = conn.prepareStatement(insertSql)) { ps.setString(1, orderNo); ps.setInt(2, customerId); ps.setInt(3, roomId); ps.setObject(4, checkinTime); ps.setBigDecimal(5, deposit); ps.setString(6, operator); ps.executeUpdate(); } // 3. 房间状态改为2（已入住） String updateSql = "UPDATE room SET status=2 WHERE id=?"; try (PreparedStatement ps = conn.prepareStatement(updateSql)) { ps.setInt(1, roomId); ps.executeUpdate(); } conn.commit(); return true; } catch (Exception e) { try { if (conn != null) conn.rollback(); } catch (SQLException ex) { ex.printStackTrace(); } return false; } finally { DBUtil.closeAll(null, null, conn); } } }

事务的要点是setAutoCommit(false)，然后全部操作成功后再commit，任何一个环节抛异常都rollback。这样即使程序在中间崩溃，数据库也不会留下半截数据。

5.4 退房结账：停留天数计算的边界问题

退房的难点在于房费计算。酒店通常按“过夜数”算钱，今天入住明天退房算一天。我用ChronoUnit.DAYS.between计算两个日期之间的天数，然后加一个最小值保护，因为有些客人可能当天入住当天退两小时就走了。

public BigDecimal calcAmount(LocalDateTime checkin, LocalDateTime checkout, BigDecimal dailyPrice) { long days = ChronoUnit.DAYS.between(checkin.toLocalDate(), checkout.toLocalDate()); if (days <= 0) { days = 1; } return dailyPrice.multiply(BigDecimal.valueOf(days)); }

这里千万别用(checkout.getTime() - checkin.getTime()) / 86400000这种整型运算，误差和边界问题会让人怀疑人生。我的做法是先按天算，再在界面里允许操作员手动修改实收金额，以适应钟点房和优惠房费。

退房完成后的数据操作也是事务：更新订单状态为1（已退房）、写入实际退房时间和消费金额、把房间状态改成3（打扫中）。

5.5 一条完整的验收用例

功能写完后，一定要按真实场景跑一遍完整流程。我以“某酒店”前台业务为例：新增一个豪华大床房，价格 328 元；添加房间 301；录入一位客人信息；给客人办理入住，收押金 500 元；确认房间状态变化为已入住；第二天正常退房；查看订单状态和房间状态。

跑通这条线只代表主流程没问题，还要再测异常场景：选一个已经入住的房间再开单，系统应该拒绝；退房金额为负时应该拦截；没有录入客人身份证时应该报错。把这些用例做成一个 checklist，后面改代码时可以反复回归。

6. 我在实际开发中踩出来的 6 个坑

代码能跑起来和稳定好用完全是两回事。下面这几个坑我几乎每带一轮新手都会见到，提前写出来，能省很多排查时间。

6.1 明明导了包，还报 ClassNotFoundException

程序写完一运行，报ClassNotFoundException: com.mysql.cj.jdbc.Driver。大概率是驱动 jar 没有被加到运行时的 classpath 里，或者你只放在了项目目录下而没导入。IDEA 里导入依赖后还要看是否出现在“外部库”列表里。命令行打包运行的时候，更要注意用java -cp .;lib/mysql-connector-java-x.jar com.hotelms.App这种带 classpath 的启动命令。

6.2 连接失败：时区、SSL、编码三连坑

MySQL 8 下经常出现The server time zone value ...或者 SSL 连接告警。前者在连接 URL 后加serverTimezone=Asia/Shanghai，后者加useSSL=false。中文乱码则多半和连接 URL 没有characterEncoding=utf8有关，同时数据库表编码要统一成 utf8mb4。我吃过一次亏，数据库建库时用了默认 latin1，后来所有中文都变成问号，最后重建库才解决。

6.3 中文在界面上变成问号

如果界面显示正常但数据库里是乱码，或者反过来，说明编码不一致。写代码时可以按这个顺序检查：源文件编码是不是 UTF-8，连接 URL 有没有指定编码，表字段是不是 utf8mb4，操作系统的默认编码有没有被设为其他字符集。IDE 右下角能看到文件编码，改完重启程序即可。

6.4 界面一查数据库就“未响应”

Swing 默认在 EDT 上执行事件。如果你在按钮点击事件里直接执行一个耗时几十秒的 SQL，界面就会卡住，鼠标转圈。零基础项目通常数据量不大，问题不明显，但换成报表统计就会露馅。正确做法是耗时的查询放到新线程里执行，再把结果通过SwingUtilities.invokeLater回写到界面。

new Thread(() -> { List<OrderVO> list = orderDao.queryByDate(start, end); SwingUtilities.invokeLater(() -> tableModel.setRows(list)); }).start();

在作业阶段能跑通用“简单同步查询”没问题，但能在答辩时说清楚为什么界面不卡，是加分项。

6.5 连接没关干净，数据库连接数被耗尽

连接忘记关闭是管理系统最常见的隐形炸弹。每次打开一个窗口就新建连接，关掉窗口连接却不释放，一段时间后数据库连接数打满，整个系统假死。解决办法有两点：一是所有Connection都要在最外层 finally 里关掉，二是尽量用我前面写的closeAll方法统一处理。如果项目要求高一点，可以引入连接池，但零基础阶段先保证“谁创建谁关闭”这个纪律。

6.6 房态并发：两个人同时开同一间房

单机训练项目很难遇到并发问题，但接到真实酒店环境，两个前台同时操作很容易出现“同一间房被开给两位客人”的局面。数据库层面可以通过SELECT ... FOR UPDATE锁行，再执行更新。代码层面开单前先检查房间状态，并且把检查和更新放在同一个事务里，就能极大降低冲突概率。

// 在事务内锁定该房间 String lockSql = "SELECT status FROM room WHERE id=? FOR UPDATE";

这种写法放到面试里，很有说服力，因为很多人完全没有考虑过并发。

7. 从“能跑”到“能交付”：测试、备份、打包一次走完

项目功能做完后，还有一个环节最容易被零基础忽略——交付。你写的代码不只给自己看，还要让别人能安装、能运行、能看到演示数据。

7.1 一份够用的功能测试清单

测试不用搞得很正式，一张表格就够了。把每个功能按照“操作步骤、预期结果、实际结果”列出，逐项签字确认。

7.2 数据库初始化与备份脚本

交付时不能只给一份代码，还要给数据库初始化脚本。用mysqldump可以导出整个结构和示例数据：

mysqldump -u root -p hotel_ms > hotel_ms_init.sql

演示环境里最好带几个房型、几间房间、几位客人的模拟数据，不然老师或客户现场看到空表，体验会差很多。我自己习惯建一个docs文件夹，把初始化脚本、安装说明、账号密码都放进去。

7.3 打包交付：别人不装 IDEA 也能运行

光靠 IDEA 里的 Run 按钮不算交付。要在项目里配置打包，把依赖的 jar 一起打进可运行包。最简单的做法是用 IDEA 的 Artifacts 功能导出可运行 jar，再把 MySQL 安装包和初始化脚本放同一个文件夹。更规范的做法是用 Maven 的maven-assembly-plugin配置，打出一个能双击运行的 jar。没有 Java 环境的电脑会要求先装 JDK，安装说明里把这步写清楚就行。

7.4 低成本加分项：报表、导出、饼图

如果还有富余时间，我会建议给系统加两个低成本高回报的功能。一个是“今日营业额”统计面板，用一段 SQL 聚合即可；另一个是把订单表格导出成 CSV 文件，用FileWriter几十行代码就能实现。这两个功能不需要引入重框架，却能显著提升项目的完整度。导出 CSV 的代码核心思路是：遍历表格模型的行，用逗号拼接写入文本文件，注意处理换行和中文编码。

8. 写在最后：如果重做一遍，我会把什么放在最前面

如果让我回到零基础状态重新做一次这套系统，我不会先写登录界面，也不会急着跑主窗口，而是花一整块时间把订单模型想清楚：订单状态有哪些，房间状态有哪些，两者在开单、换房、退房、取消时分别怎么变化。这是我带过项目之后最大的体会——数据模型是整棵树的根，界面和业务逻辑都是树干上长出来的枝叶，根如果歪了，后面每次都难受。做 Java Swing + MySQL 的酒店管理系统，难点从来不是某个组件的用法，而是把数据库表、事务边界、界面事件这三层串起来的能力。照着手敲，敲完再自己改两个功能，比如加一个“会员折扣”或者“每日营收柱状图”，你对这套系统的理解就和只看不写的同学彻底拉开差距了。