简介这是一份基于Python开发的酒店管理系统数据库课程设计项目面向数据库课程设计、期末大作业与毕业设计场景也适合想通过完整项目入门Python开发的新手。工程使用Qt Designer设计交互界面以PyQt实现登录、客房、员工、报表等常用业务模块SQL脚本完成数据表创建与初始数据导入配套系统设计报告、E-R图与功能结构图可清晰还原从需求分析、表结构设计到编码实现的全过程压缩包共61个文件核心为18个Python源文件另有8个UI界面文件、3个SQL脚本及2份PDF设计文档整体仅8.3MB下载后按文档指引简单配置环境即可运行。代码注释详实逻辑直白便于对照学习与二次改造该项目为手打完成曾获98分成绩也是导师认可的高分作业范例。目前已有382人浏览学习适合需要快速搭建可演示系统并提交完整报告的同学。1. 数据库课程设计从零到 98 分这套 Python 酒店管理系统拆给你看每年数据库课程设计季总有人卡在同一个路口题目好找代码难写抄来的项目看不懂讲不明白答辩被导师一问就露馅。这套基于 Python 的酒店管理系统正好卡在课程设计的“标准答案”区间——PyQt5 做桌面界面、MySQL 做数据存储、Python 做业务逻辑三层结构清晰代码注释完整还附带 E-R 图、功能结构图、系统设计报告和课程设计报告属于下载下来简单部署就能跑跑完能改、改完能讲、讲完能答辩的完整闭环。适合三类人数据库课程设计要交作业的在校生、期末大作业想拿高分但不想从零啃 PyQt 的实战派、以及毕业设计需要一套可扩展管理系统骨架的入门选手。2. 先看懂整体架构登录、房间、员工、报表四条业务线2.1 从文件清单反推系统设计思路拿到资源包之后先别急着双击运行。我拆项目的习惯是先看文件结构因为这能直接反映作者的设计思路。这个压缩包里的核心文件分四组第一组是入口和主逻辑Main.py 是启动入口LoginUI 负责登录窗口MainUI 是登录后的主界面ModifyPwd 处理密码修改这几个文件构成系统的最外层交互。第二组是业务实体类room.py 对应房间管理staff.py 对应员工管理report.py 对应报表统计。这里有个关键设计思路——每个业务模块都有独立的类文件和对应的 UI 文件room.ui、staff.ui、report.ui说明作者用的是“界面与逻辑分离”的写法而不是把所有代码堆在一个文件里。这种分层方式在课程设计里非常讨巧导师看代码结构就能给你加分。第三组是数据库相关hotelManagement.sql 是建库建表脚本E-R_diagram.jpg 和 Functional_structure_diagram.png 是设计文档配图这两张图在系统设计报告里会用到。第四组是说明文档《课程设计〈数据库应用〉内容要求.pdf》告诉你老师要什么《〈数据库应用〉系统设计报告.pdf》告诉你这份资源怎么对应老师的要求。这套分层结构对应的是经典的“表示层-业务层-数据层”三层架构虽然不是完整的企业级分层但在课程设计这个量级上足够清晰。答辩时你就按照“UI 层负责交互、实体类负责业务规则、SQL 脚本负责数据持久化”这条线讲导师一听就知道你是真拆过项目。2.2 数据库表设计从 hotelManagement.sql 看表结构和外键关系数据库大作业的核心评分点首先是表设计。打开酒店管理系统的 hotelManagement.sql 文件能看到完整的建库建表语句。典型的表设计会包含这几张管理员/员工表、房间类型表、房间表、入住/预订记录表。从资源包里的文件推断这个项目的表设计逻辑大致是员工表staff存工号、姓名、角色权限、登录密码等字段密码用明文还是密文取决于作者习惯但是课程设计阶段为了答辩演示方便一般用简单加密或直接明文这个在答辩时会成为提问点。房间表room核心字段是房间号、房型、价格、状态空闲/入住/打扫。入住记录表记录客户入住、退房、消费流水外键关联员工表和房间表。如果你打开 SQL 文件注意看外键约束的写法。常见做法是用FOREIGN KEY声明关联关系同时设置ON DELETE CASCADE或ON UPDATE RESTRICT。这个细节答辩经常被问到——“删除一条员工记录时对应的入住记录怎么办”如果你回答“因为设置了级联删除所以记录同步删除”这就是一个完整的数据库完整性知识点。2.3 PyQt5 MySQL 的选型逻辑为什么课程设计用它最稳用 Python 做数据库课程设计搭子一般有三个选择Tkinter、PyQt5、Web 框架Flask/Django。这套资源选了 PyQt5 MySQL原因是从上手难度看PyQt5 的控件拖拽式设计配合 Qt Designer比手写 Tkinter 布局要直观初学者不需要理解 pack/grid 布局的复杂嵌套。从答辩效果看PyQt5 做出来的界面有现代感比 Tkinter 的原生控件好不少演示时观感加分。从数据层看MySQL 比 SQLite 更“像个正经数据库”因为课程设计通常需要展示 E-R 图、关系模式、范式分析MySQL 的表格和约束能对应上这些理论。代码层面连接 MySQL 的常见写法是import pymysql def get_connection(): conn pymysql.connect( hostlocalhost, port3306, userroot, password123456, databasehotel_management, charsetutf8mb4, cursorclasspymysql.cursors.DictCursor ) return conn这段代码每次执行 SQL 时新建一个连接执行完再关闭。逻辑清楚参数含义分别是host指数据库所在主机本地开发写localhostport是 MySQL 默认端口 3306user和password是登录凭据database指定要操作的库名charsetutf8mb4保证中文不乱码DictCursor让查询结果以字典形式返回取值时用row[field_name]比用下标更直观。这个连接函数是整个系统的数据入口任何业务模块调用它就能执行 SQL。课程设计阶段不用考虑连接池优化但答辩老师如果问“并发访问怎么办”你要能说“生产环境会用连接池这里为了展示基础原理采用每次新建连接”。3. 把系统跑起来环境搭建与三步部署法3.1 安装依赖环境Python 版本、pip 包、MySQL 准备部署之前先把环境装齐。这套系统依赖以下组件组件版本建议说明Python3.8 - 3.11PyQt5 对 3.12 支持不完善建议用 3.10 最稳PyQt55.15.xUI 框架核心包pymysql1.xMySQL 驱动MySQL5.7 或 8.0数据库服务端安装命令pip install pyqt55.15.9 pymysql1.0.2注意 PyQt5 的版本锁死是血泪经验——不锁版本的话 pip 可能装出 5.15.11 或更高版本某些控件 API 有细微变动可能导致现有代码报错。MySQL 建议装 8.05.7 也兼容但 8.0 的 utf8mb4 默认配置更好。3.2 导入数据库用 MySQL 命令行或图形化工具执行 SQL 脚本数据库文件 hotelManagement.sql 是建库建表脚本需要手动导入 MySQL。最常见的两种方式方式一命令行导入mysql -u root -p hotelManagement.sql执行后输入 root 密码脚本会自动完成建库、建表、插入初始数据。注意文件名路径别写错Windows 下如果 SQL 文件在桌面先cd到对应目录再执行。方式二用 Navicat 或 MySQL Workbench 导入打开图形化工具连接到本地 MySQL右键“运行 SQL 文件”选择酒店管理系统的 SQL 脚本执行即可。这种方式的好处是能看到每条语句的执行结果报错时能定位到具体行。导入成功后建议用一个简单查询验证USE hotel_management; SHOW TABLES; SELECT * FROM staff;如果能看到初始化的管理员账号数据行说明脚本执行成功如果报权限错误检查 MySQL root 账号是否允许本地登录。3.3 修改数据库连接参数db_config 里的密码和库名代码里大概率有一个数据库配置文件可能是 config.py也可能直接在 Main.py 或各业务文件顶部写死连接参数。按住 CtrlShiftF 全局搜pymysql.connect找到后检查这四样东西password是否等于你本地 MySQL 的 root 密码默认写的可能是123456或root。database是否和 SQL 脚本里CREATE DATABASE的库名一致常见的坑是脚本里建库叫hotel_management代码里连的是hotel。host不要写远程地址本地就localhost。port默认 3306如果你装的是 MySQL 8 且改过端口要同步修改。改完之后先跑一个最简单的测试from Main import get_connection conn get_connection() print(连接成功 if conn else 连接失败) conn.close()这一步的意义是“先验证数据层再启动 UI”不然你双击 Main.py 报错了很难分清是数据库问题还是代码问题。3.4 三种启动方式直接运行、命令行跑、IDE 调试系统跑起来有三种方式按调试便利性排序方式一推荐新手用 PyCharm 打开项目根目录右键 Main.py 选择 Run。PyCharm 会自动识别项目结构和虚拟环境如果有缺包会在控制台提示。方式二命令行运行python Main.py前提是依赖包已经安装好且命令行的 Python 版本和安装包的版本一致。Windows 下如果提示“不是内部或外部命令”检查 Python 是否加入了 PATH 环境变量。方式三开发调试模式运行python -m cProfile Main.py给熟手的一条命令可以看函数调用耗时定位性能瓶颈。课程设计阶段一般用不上但答辩时如果老师问“系统有没有做性能优化”你回答“用 cProfile 分析过热点函数”是一个亮眼的加分项。4. 代码走读与二次开发不只会跑还要会改4.1 登录模块的完整流程从 LoginUI 到 MainUI 的跳转逻辑登录模块是整个系统第一个被导师看到的界面也是答辩演示的第一个环节。代码逻辑可以总结为三步读取用户输入 → 校验数据库 → 跳转主界面或报错。核心代码简化版from PyQt5.QtWidgets import QMessageBox import pymysql def check_login(self): username self.username_input.text().strip() password self.password_input.text().strip() if not username or not password: QMessageBox.warning(self, 提示, 用户名和密码不能为空) return conn get_connection() cursor conn.cursor() sql SELECT * FROM staff WHERE username%s AND password%s cursor.execute(sql, (username, password)) result cursor.fetchone() cursor.close() conn.close() if result: self.main_window MainUI() self.main_window.show() self.close() else: QMessageBox.critical(self, 错误, 用户名或密码错误)逻辑说明先做非空校验避免把空字符串发给数据库。使用参数化查询%s而不是字符串拼接这是防 SQL 注入的标准手法答辩时老师极大概率会问“你怎么防 SQL 注入”你要能说出“用参数化查询代替拼接”。登录成功后创建MainUI()对象并show()同时close()当前登录窗口——这里注意不是hide()close()会释放登录窗口资源避免内存泄漏。参数说明self.username_input和self.password_input是在 Qt Designer 中给输入框命名的对象名objectName如果你用 Qt Designer 重新设计了 UI对象名没保持一致代码就会报 AttributeError。4.2 房间管理模块增删改查的标准实现与状态流转房间管理是系统的核心业务模块对应 room.py。逻辑围绕“房间状态”展开空闲 → 入住 → 退房 → 空闲或打扫中。一个典型的房间查询代码片段def query_rooms(self, room_typeNone, statusNone): conn get_connection() cursor conn.cursor() sql SELECT * FROM room WHERE 11 params [] if room_type: sql AND room_type%s params.append(room_type) if status: sql AND status%s params.append(status) cursor.execute(sql, params) rows cursor.fetchall() cursor.close() conn.close() return rows这段代码用了“11 动态拼接条件”的技巧。初始 SQL 写WHERE 11是为了后面拼接AND room_type%s时不用判断是否有 WHERE逻辑简单且代码可读性好。参数使用列表params收集执行时展开传入保持参数化查询的一致性。二次开发时如果你想增加“按价格区间筛选”只需要把代码改成if min_price: sql AND price %s params.append(min_price) if max_price: sql AND price %s params.append(max_price)这样的改动不会破坏原有逻辑是教科书级别的渐进式扩展。4.3 报表模块用 SQL 聚合函数生成统计图表报表模块是拉开分数差距的地方。基础版的房间管理系统只需要增删改查但带报表统计就能体现“你对 SQL 聚合查询有真实理解”。report.py 里常见的统计逻辑是统计每月入住率、统计各房型收入、统计员工接待量。对应 SQLSELECT DATE_FORMAT(check_in_date, %Y-%m) AS month, COUNT(*) AS total_orders, SUM(total_amount) AS revenue FROM checkin_records GROUP BY DATE_FORMAT(check_in_date, %Y-%m) ORDER BY month DESC;DATE_FORMAT把日期格式化到月份粒度GROUP BY按月分组SUM汇总收入COUNT统计订单数。这条 SQL 是报表模块的骨架配合 PyQt5 的 QTableWidget 展示效果不输商业系统。如果是带图表的高级版本可以用matplotlib嵌入 PyQt5把月度收入画成折线图。这个不是必须项但如果毕业论文里要写“系统的可视化分析”加一个图表就是亮点。4.4 UI 文件的修改方式Qt Designer 打开 .ui 文件改完再转 .py这套系统的 UI 是 Qt Designer 设计稿文件后缀是.ui运行时由 Python 动态加载。修改界面的正确工作流是打开 Qt Designerpip 安装 PyQt5 时自带命令行输入designer启动。通过菜单 File → Open 打开room.ui或staff.ui。拖拽调整控件、改字体颜色、调布局。保存后有两种用法一是保持 .ui 文件动态加载代码里用loadUi读取二是转为 .py命令行执行pyuic5 -x room.ui -o room_ui.py再 import。注意一个关键差异如果代码里已经用了.ui文件动态加载方式你只需要替换 .ui 文件界面改动就生效不需要动 Python 代码如果用pyuic5转成了 .py那代码里的 import 路径也要跟着改。混用就会导致“改了 UI 但界面没变化”的玄学问题。5. 避坑手册六个常见部署与二次开发问题全记录5.1 运行报错 ModuleNotFoundErrorNo module named ‘PyQt5’现象双击 Main.py控制台直接报ModuleNotFoundError: No module named PyQt5。原因这台机器的 Python 环境里根本没装 PyQt5或者装到了别的 Python 版本上比如系统自带 Python 3.9 和 Anaconda Python 3.10 共存pip 装到了 Anaconda命令行用系统 Python 跑。解决先确认你运行 Main.py 用的解释器是哪一个。PyCharm 右下角可以查看当前解释器路径命令行执行pip list | findstr PyQt5Windows或pip list | grep PyQt5macOS/Linux确认包已安装。如果是环境混用直接激活目标环境再装conda activate base pip install pyqt5 pymysql python Main.py5.2 数据库连接报错Access denied for user ‘root’‘localhost’现象启动系统后只要执行任何数据库操作就弹窗报错pymysql.err.OperationalError: (1045, Access denied for user rootlocalhost)。原因代码里写的数据库密码和你本地 MySQL 的 root 密码不一致。也可能是 MySQL root 账号根本没有远程登录权限但本地 localhost 一般默认允许。解决打开 MySQL 命令行用你知道的密码登录mysql -u root -p如果能登录说明密码没问题去代码里把所有pymysql.connect()的password参数改成你实际用的密码。如果 SQL 脚本里建库名和代码的database参数不一致也会报类似错误统一改成脚本里CREATE DATABASE语句定义的库名。5.3 中文字符乱码界面显示问号或乱码现象房间类型显示成“???”或者“房闔之类界面一片混乱。原因数据库表编码不是 utf8mb4或者连接时没指定 charset。MySQL 默认 latin1存中文必乱码SQL 脚本里如果没有DEFAULT CHARSETutf8mb4导入后表就是 latin1。解决修改 MySQL 端和 Python 端的编码声明。MySQL 端ALTER DATABASE hotel_management CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ALTER TABLE room CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;Python 端确保连接参数里charsetutf8mb4。另外重新导入 SQL 文件前检查脚本开头的建库语句是否带了DEFAULT CHARACTER SET utf8mb4。5.4 PyQt5 窗口显示但按钮没反应现象登录界面能打开但点击“登录”按钮没有任何响应也不报错。原因按钮 click 信号没有连接到对应的槽函数。最常见的原因是 Qt Designer 里改了按钮的 objectName但代码里self.xxx.clicked.connect(...)引用的还是旧名称。解决检查按钮属性和连接代码。在 Qt Designer 里选中按钮看 objectName 叫什么然后回到代码搜索.clicked.connect确认连接的是同一个名称。比如按钮叫btn_login那代码应该是self.btn_login.clicked.connect(self.check_login)如果名字对不上要么改代码要么在 Designer 里改回原名。这个坑非常隐蔽因为界面正常显示但交互层是断的。5.5 切换界面时程序卡死或无响应现象从登录页跳转到主界面时整个窗口变成“白屏”或 Windows 提示“未响应”。原因主界面初始化时同步执行了耗时操作比如一次性加载全部房间数据并刷新表格阻塞了 UI 线程。PyQt5 的 UI 线程不能干重活所有耗时任务要放子线程或延迟加载。解决如果只在跳转时有这个问题把初始化的查询改成延迟加载class MainUI(QMainWindow): def __init__(self): super().__init__() self.loadUi() # 不用 QTimer.singleShot 延迟加载数据 QTimer.singleShot(100, self.init_data) def init_data(self): rooms self.query_rooms() self.refresh_table(rooms)QTimer.singleShot(100, self.init_data)的含义是100 毫秒后让事件循环先画完界面再执行数据加载用户不会感知到卡顿。5.6 电脑没有 MySQL 但必须演示现象答辩教室的电脑没有安装 MySQL 数据库服务现场演示时系统连不上数据库。原因MySQL 是独立服务代码连不上就全盘崩溃。课程设计答辩场地往往不具备安装 MySQL 的条件。解决三个思路。一是在自己电脑上提前演示录好视频作为答辩材料二是把 MySQL 改成便携版用 MySQL 的 zip 免安装包复制到 U 盘答辩时解压启动服务三是改配置连接远程 MySQL但不建议答辩现场网络不稳定。最稳的方法是双手准备本地正常演示 提前录好备用的完整操作视频。6. 从 85 到 98 分的进阶路径答辩前必做的三个验证6.1 用系统设计报告反推答辩逻辑框架拿到手的系统设计报告 PDF不只是交作业用的更是答辩的提词器。我一般会做一件事把报告里的每一章标题转成一个答辩问题然后自己对着镜子回答一遍。比如“系统需求分析章节”对应的提问是“你这个系统解决了什么问题”。回答思路酒店前台需要一个能管理房间状态、登记客人信息、办理入住退房、查看营业数据的工具Excel 做不到实时联动所以做了一个数据库管理系统。“数据库设计章节”对应的提问是“你的 E-R 图里实体和联系都有哪些”。回答思路员工、房间、客人是三个主要实体入住记录是联系多对多的关系通过中间表拆分。说到这里指着课程设计里的 E-R_diagram.jpg导师的认可度会明显不一样——因为大部分同学连自己画没画过 E-R 图都说不清。6.2 数据完整性验证外键、约束、级联操作测试系统交付之前我建议做一遍完整的数据完整性测试。在 MySQL 里手动执行几个破坏性操作看系统能不能兜住第一查外键是否正确。打开 SQL 脚本确认从表的外键字段是否都声明了 REFERENCES。如果某张表应该关联员工表却没写外键这就是设计缺陷答辩老师翻到表结构就会问。第二测约束是否生效。插入一条 duplicate 的主键记录看数据库是否报错。第三测级联行为。课程设计阶段的系统删除员工时如果有关联的入住记录SQL 脚本里要决定是ON DELETE RESTRICT有记录就不让删还是ON DELETE CASCADE连坐删除。推荐RESTRICT因为它更安全逻辑也更简单答辩时能说出“防止误删核心数据”。6.3 答辩前的一个小习惯录一段 3 分钟全流程演示答辩翻车往往不是系统不行而是操作手抖。我从拆过多个课程设计项目的经验里总结出一个笨办法用录屏工具录一段 3 分钟的全流程演示从登录开始到添加房间、办理入住、退房结算、查看报表全程录好。答辩时即使现场电脑出了幺蛾子也可以直接播放录屏救场同时配合口述逻辑。从那以后我每次拿到别人的课程设计项目不管代码接不接触都会强制先跑一遍完整功能再用录屏存档最后才拆代码结构。这个过程帮我避开了太多“演示前一秒数据库连不上”的尴尬。希望帮到你把这份酒店管理系统的价值完整榨出来。本文还有配套的精品资源点击获取