拓冰网站定制 
简介一份基于QT与MySQL的点餐系统完整项目源码面向C/QT初学者及需要完成课程设计、毕业设计的高校学生也适合想了解桌面端数据库应用开发的开发者参考。项目围绕餐厅点餐场景将窗口界面、业务逻辑与MySQL数据库连接整合在一起提供完整可编译运行的工程无需修改即可在本地环境部署体验契合高分课设的交付要求。压缩包共18个文件约385KB核心包含4个C源文件、3个头文件、2个QT界面文件以及工程配置文件另有QSS样式表和QRC资源文件负责界面美化与图片素材管理结构完整清晰便于按模块查看和替换素材。资源目前已有644人学习下载适合有C基础、希望快速上手QT数据库开发的读者。拿到后可对照代码学习窗口布局、控件信号槽、数据库连接与增删改查等关键知识点也能直接更换界面图片或样式用于汇报演示省去从零搭建环境和排错时间是课设实战与答辩准备的现成参考。1. 基于 QTMYSQL 的点餐系统源码从驱动跑到前台收银最该先读的是数据库部分真正做过点餐系统的人都有体会QT 界面从来不是最耗时间的最耗时间的是 MySQL 驱动装不上、中文菜名存进去再读出来变成问号、下单时订单主表和明细表没写全月底对账才发现少了两道菜。所谓“基于 QTMYSQL 的点餐系统源码全部资料.zip”通常打包着三样东西Qt Creator 工程、MySQL 建表脚本、界面资源和部署说明。它的价值不是让你学会画一个按钮而是让你在最短时间内看懂一套小型 MIS 系统的骨架排桌、点菜、下单、结账、统计数据怎么流转、哪里容易翻车。想快速跑通毕业设计、接手小饭店收银台或者拿这套结构改造成进销存都可以把这篇当落地说明书用。2. 点餐系统的功能域与 QT/MySQL 选型先把这套源码拆成五个模块再动手2.1 点餐系统的五个功能域与数据流转点餐系统不是一个“大前端页面”它本质上是一个订单管理系统。按下单链路拆功能域会非常清晰菜单管理维护菜品分类、菜名、价格、上下架状态桌台管理桌位编号、容量、占用/空闲状态支持换桌点餐下单选菜、改数量、计算金额生成订单后先落主表再落明细后厨联动多数小型源码不做实时通信而是靠订单状态字段加定时刷新后厨看到新订单就备菜结算统计日结、月结、菜品销量排行直接对订单表和明细表做聚合查询。数据流是单向的QT 界面拿到用户操作包装成 SQL 发给 MySQL再用查询结果刷新界面。QT 本身不承担存储职责所有桌台、菜品、订单状态都以数据库为准。这套架构下“点餐”类项目恰好是 QT 的 Model/View 框架最舒服的场景QTableView只负责显示QSqlQueryModel负责拉数据界面逻辑和数据访问逻辑长时间不会互相污染。2.2 为什么常见方案都选 QT Widgets MySQL而不是 QML / SQLite很多新手第一次解压这类源码会嫌弃界面“老气”。原因不是作者审美差而是点餐系统的使用场景大多是 Windows 收银机、嵌入式触摸屏要求低资源占用、键盘鼠标协同操作、长时间不崩溃。QML 做酷炫动画和触屏交互很在行但收银台需要焦点快速跳转、表格批量编辑、弹窗输密码这些用QWidget配QTableView、QLineEdit、QDialog更成熟保守出问题了也能从海量历史资料里找到答案。数据库选型上SQLite 不是不能跑但点餐系统一旦出现前厅点菜、后厨确认、老板查报表同时发生的场景SQLite 的写锁会直接卡住整个业务。MySQL 的 InnoDB 引擎提供行级锁、事务、崩溃恢复对这类多终端小型系统来说属于必需基础。需要留意的是 MySQL 5.7 和 8.0 的差异新的 QT 驱动和 libmysql 动态库基本都适配 8.x但老源码里如果写着mysql_native_password相关配置在 MySQL 8 默认caching_sha2_password下可能报认证错误这个坑我会在第 5 章单独展开。2.3 “全部资料”里的典型结构先找到 .pro、db 脚本、res 目录“全部资料”四个字虽然不属于任何官方命名但这类压缩包解压后百分之七八十是下面这个骨架OrderSystem/ ├── OrderSystem.pro # qmake 工程文件Qt 版本和模块在这里声明 ├── db/ │ ├── order_system.sql # 建库建表 初始化数据脚本 │ └── 数据库说明.txt # 账号、密码、字符集、版本要求 ├── src/ │ ├── main.cpp │ ├── mainwindow.ui # 主窗体布局XML 描述 │ ├── dlg_login.ui # 登录窗口 │ ├── dbmanager.h/cpp # QSqlDatabase 封装通常做单例 │ └── xxxwidget.h/cpp # 各功能模块界面逻辑 ├── res/ │ ├── icons/ # 菜品图、按钮图标 │ └── qss/ # 样式表 ├── build/ # 有些包会连带编译产物一起发 └── 部署说明.md拿到压缩包先别急着双击 exe按顺序确认三件事第一db/order_system.sql能不能在目标 MySQL 里完整执行第二Qt 编译产物旁边有没有sqldrivers目录下的qsqlmysql.dll或libqsqlmysql.so这决定程序能不能真正连上 MySQL第三res/icons里的图片来源是不是写了绝对路径很多项目复制到别人电脑后图片加载不出来就是代码里写死了C:/Users/xxx/Desktop/...这种地址。2.4 拿到压缩包之后的三个动作灌库、装 Qt 5.15.2、改连接参数如果你是从零接手一个“QTMYSQL 点餐系统源码包”我的习惯动作是三步先用 MySQL Workbench 或者命令行把 SQL 脚本整库跑一遍确认表都建出来了再从 Qt 官网装一个与.pro文件匹配的版本常见写法是QT core gui sql如果里面带charts就需要装带charts模块的安装包最后打开dbmanager或main.cpp里写死的那行连接参数改成自己本机的库名、用户、密码。这里补一句版本建议如果源码是在 Qt 5.15 下写的我一般不会硬着头皮升 Qt 6因为QT sql之外还有webenginewidgets、charts等模块在 Qt 6 里变动很大强行编译只会浪费几个小时在无关错误上。先把 5.15.2 跑通把业务验证完再评估升级 Qt 6 的成本这个顺序最省钱。3. MySQL 表设计是整套系统的心脏建表、初始化数据与事务落地3.1 五张核心表的关系与字段设计点餐系统的表不一定多但每一张都承担明确职责。典型设计最少五张表分类表category、菜品表dish、桌台表dining_table、订单主表orders、订单明细表order_detail。我见过一些非正规源码把菜品分类直接塞在菜品表里用字符串存短期能跑但你想改分类名、按分类统计销量时就会非常痛苦。CREATE DATABASE IF NOT EXISTS order_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE order_system; CREATE TABLE category ( id INT NOT NULL AUTO_INCREMENT, name VARCHAR(50) NOT NULL COMMENT 分类名称如热菜/凉菜/饮品, sort_order INT NOT NULL DEFAULT 0 COMMENT 排序权重小的排前面, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE dish ( id INT NOT NULL AUTO_INCREMENT, category_id INT NOT NULL, name VARCHAR(100) NOT NULL COMMENT 菜名, price DECIMAL(10,2) NOT NULL DEFAULT 0.00 COMMENT 零售价, status TINYINT NOT NULL DEFAULT 1 COMMENT 1上架 0下架, image VARCHAR(255) DEFAULT NULL, PRIMARY KEY (id), KEY idx_category (category_id), CONSTRAINT fk_dish_category FOREIGN KEY (category_id) REFERENCES category (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;两点参数说明一是价格用DECIMAL(10,2)绝不用FLOAT否则精确计算金额时会出现 0.1 0.2 0.30000000000000004 之类的浮点误差二是字符集统一utf8mb4它比utf8多支持 emoji 和生僻字菜名里有“”这种字也不会崩。外键这里我只在dish→category上加订单相关的外键下一节给因为外键会影响写入性能要在点餐系统里平衡使用。3.2 初始化数据与字符集utf8mb4、DEFAULT 0、排序规则建表之后必须有一批初始数据否则程序一启动菜单区就是空的界面看起来就像死机。初始化脚本常见写法是把分类和菜品直接 INSERT再给桌台生成 10 或 20 个座位记录INSERT INTO category (name, sort_order) VALUES (热菜, 1), (凉菜, 2), (主食, 3), (饮品, 4); INSERT INTO dish (category_id, name, price, status) VALUES (1, 宫保鸡丁, 28.00, 1), (1, 水煮鱼, 68.00, 1), (2, 凉拌黄瓜, 16.00, 1), (3, 米饭, 3.00, 1); INSERT INTO dining_table (table_no, seat_count, status) VALUES (A001, 4, 0), (A002, 4, 0), (A003, 6, 0), (B001, 8, 0), (B002, 10, 0);这里跟着热搜词走一个小细节mysql 设置默认值为 0在点餐系统里非常常用。桌台status默认 0意思是“空闲”下单成功后由程序改成 1菜品status默认 1意思是“上架”。一张 TINYINT 字段用 0/1 表示状态比用字符“空闲/占用”更省空间也更好写 WHERE。唯一要注意的是接口层必须做注释不然三个月后你自己都不知道status0是空闲还是下架。sort_order字段建议保留它解决“分类顺序总是乱跳”的问题。很多源码表里根本没有这个字段菜单顺序完全依赖 INSERT 顺序一旦删过数据顺序就乱了。有sort_order之后ORDER BY sort_order, id就能稳定复现人工排好的顺序。3.3 下单事务与存储过程订单和明细不能分两步提交点餐系统最大的逻辑风险是用户点了五个菜界面提示下单成功但数据库订单明细表里只有四个菜。这种事故几乎都是因为“先插订单主表再插明细表”之间没有任何事务保护。事务的意义不是让你的 SQL 变快而是让多条 SQL 语句要么全部成功要么全部失败。START TRANSACTION; INSERT INTO orders (table_id, order_no, total_amount, status) VALUES (1, 20250608120000123, 0, 0); SET order_id LAST_INSERT_ID(); INSERT INTO order_detail (order_id, dish_id, dish_name, price, quantity, amount) VALUES (order_id, 1, 宫保鸡丁, 28.00, 2, 56.00), (order_id, 2, 水煮鱼, 68.00, 1, 68.00), (order_id, 4, 米饭, 3.00, 2, 6.00); UPDATE dining_table SET status 1 WHERE id 1; COMMIT;LAST_INSERT_ID()是这条事务里最值得记住的函数它返回当前连接上一次 INSERT 产生的自增主键而且天然是“会话级安全”的两个客户端同时下单也不会互相拿到对方的 ID。如果把整个下单流程封装成 MySQL 存储过程比如CALL sp_create_order(1, ...)客户端就只需要一行调用代码这种方案在源码包里也经常见到适合网络环境不稳、防止逻辑被客户改坏的场景DELIMITER $$ CREATE PROCEDURE sp_create_order(IN p_table_id INT, IN p_order_no VARCHAR(32)) BEGIN DECLARE v_order_id BIGINT; START TRANSACTION; INSERT INTO orders (table_id, order_no) VALUES (p_table_id, p_order_no); SET v_order_id LAST_INSERT_ID(); -- 明细表的写入由调用方逐条传入这里只演示骨架 COMMIT; END$$ DELIMITER ;事务还有个隐藏价值它是点餐系统的“后悔药”。结账时发现用户退菜不能真的把明细 DELETE 掉而是另一条状态为负数的冲正明细。有了事务退菜和冲正就能在同一事务里完成不会出现退菜成功、金额没减的半吊子状态。4. 用 QT 把 MySQL 跑通的最小代码驱动检查、单例封装、菜单加载与下单事务4.1 先查驱动再写连接QMYSQL driver not loaded 是第一道坎很多源码包在你本机编译一次通过拷到别的电脑就变成QSqlDatabase: QMYSQL driver not loaded。原因是 Qt 的 MySQL 插件是动态库插件默认安装时不一定带上或者运行时找不到。所以写任何连接代码之前先做驱动自检#include QSqlDatabase #include QDebug int main(int argc, char *argv[]) { // 程序启动第一件事确认 MySQL 驱动是否存在 QStringList drivers QSqlDatabase::drivers(); qDebug() 当前可用的数据库驱动: drivers; if (!QSqlDatabase::isDriverAvailable(QMYSQL)) { qCritical() QMYSQL driver not loaded后续所有数据库操作都会失败; return -1; } return 0; }QSqlDatabase::drivers()返回的是当前插件目录下所有可用驱动名看到QMYSQL才算过关。一个小概率情况是驱动在但在错误路径Qt 的sqldrivers插件必须和libmysql.dll放在一起程序才能加载。如果自检输出里只有QSQLITE需要重新安装带 MySQL 插件的 Qt或者从另一台同版本 Qt 的plugins/sqldrivers目录里拷贝qsqlmysql.dll。4.2 数据连接单例封装配置写入 config.ini换电脑不重新编译源码包里最常见的连接错误就是把 root 密码写死在代码里。正确的做法是读外部配置文件这样部署到后厨电脑时只需要改 ini 文件不需要重新编译。单例封装的写法// dbmanager.h #pragma once #include QSqlDatabase class DbManager { public: static DbManager instance(); QSqlDatabase database(); bool open(); private: DbManager(); QSqlDatabase m_db; };// dbmanager.cpp #include dbmanager.h #include QSqlError #include QSettings #include QVariant DbManager DbManager::instance() { static DbManager inst; // C11 局部静态变量线程安全 return inst; } DbManager::DbManager() { // config.ini 放在 exe 同目录方便现场工程师直接改 QSettings config(config.ini, QSettings::IniFormat); m_db QSqlDatabase::addDatabase(QMYSQL, order_conn); m_db.setHostName(config.value(mysql/host, 127.0.0.1).toString()); m_db.setPort(config.value(mysql/port, 3306).toInt()); m_db.setDatabaseName(config.value(mysql/dbname, order_system).toString()); m_db.setUserName(config.value(mysql/user, root).toString()); m_db.setPassword(config.value(mysql/pass, ).toString()); } bool DbManager::open() { if (!m_db.open()) { qCritical() 数据库打开失败 m_db.lastError().text(); return false; } return true; } QSqlDatabase DbManager::database() { return m_db; }注意这里QSqlDatabase::addDatabase(QMYSQL, order_conn)给了连接一个名字而不是用默认连接。多并发窗口操作时每个查询拿同一个 connection 名会互相干扰如果源码里需要开多个连接用不同名字注册即可。另外打开失败时最好打印lastError().text()它会直接告诉你Access denied for user还是Cant connect to MySQL server这比猜原因快得多。4.3 用 QSqlQueryModel 把菜品表搬到 QTableView菜单窗口的本质是“SELECT 一张表显示在表格里”。用QSqlQueryModel最直接void MainWindow::loadMenu() { // 查询上架菜品按分类排好 QSqlQueryModel *model new QSqlQueryModel(this); QString sql SELECT d.id, c.name AS category, d.name AS dish_name, d.price FROM dish d JOIN category c ON d.category_id c.id WHERE d.status 1 ORDER BY c.sort_order, d.id; model-setQuery(sql, DbManager::instance().database()); if (model-lastError().isValid()) { QMessageBox::critical(this, 加载菜单失败, model-lastError().text()); return; } model-setHeaderData(0, Qt::Horizontal, 菜品ID); model-setHeaderData(1, Qt::Horizontal, 分类); model-setHeaderData(2, Qt::Horizontal, 菜名); model-setHeaderData(3, Qt::Horizontal, 价格); ui-tableViewMenu-setModel(model); ui-tableViewMenu-setColumnWidth(2, 180); // 菜名列宽一点中文不换行 ui-tableViewMenu-horizontalHeader()-setStretchLastSection(true); }这里有两层逻辑值得说明。第一直接JOIN category拿分类名而不是在 QT 代码里再查一次分类表一次 SQL 解决显示问题网络往返少一次。第二QSqlQueryModel是只读模型适合展示菜单如果要做“双击菜品加购”这类交互通常是在selectionModel()上连接信号槽拿当前行数据而不是直接改模型。setQuery的第二个参数必须传已经 open 的数据库对象否则模型不知道去哪条连接查询。4.4 下单事务一次点餐写三张表的正确姿势下单是点餐系统唯一的“写多读少”操作一次点击要同时写订单主表、订单明细表、更新桌台状态。QT 里用QSqlDatabase::transaction()包住这三步保证中途任何一步失败都能整体回滚bool OrderService::createOrder(int tableId, const QVectorOrderItem items) { QSqlDatabase db DbManager::instance().database(); db.transaction(); QSqlQuery q(db); q.prepare(INSERT INTO orders (table_id, order_no, total_amount, status) VALUES (:table_id, :order_no, :total_amount, 0)); QString orderNo QDateTime::currentDateTime().toString(yyyyMMddhhmmsszzz); double total 0.0; for (const OrderItem item : items) { total item.price * item.quantity; } q.bindValue(:table_id, tableId); q.bindValue(:order_no, orderNo); q.bindValue(:total_amount, total); if (!q.exec()) { db.rollback(); qCritical() 写订单主表失败 q.lastError().text(); return false; } QVariant orderId q.lastInsertId(); for (const OrderItem item : items) { QSqlQuery qd(db); qd.prepare(INSERT INTO order_detail (order_id, dish_id, dish_name, price, quantity, amount) VALUES (:order_id, :dish_id, :dish_name, :price, :quantity, :amount)); qd.bindValue(:order_id, orderId); qd.bindValue(:dish_id, item.dishId); qd.bindValue(:dish_name, item.dishName); qd.bindValue(:price, item.price); qd.bindValue(:quantity, item.quantity); qd.bindValue(:amount, item.price * item.quantity); if (!qd.exec()) { db.rollback(); qCritical() 写订单明细失败 qd.lastError().text(); return false; } } QSqlQuery ut(db); ut.prepare(UPDATE dining_table SET status 1 WHERE id :table_id); ut.bindValue(:table_id, tableId); if (!ut.exec()) { db.rollback(); return false; } if (!db.commit()) { db.rollback(); return false; } return true; }参数说明上有三个细节订单号orderNo用yyyyMMddhhmmsszzz生成14 位字符串这种一串数字放满汉字的VARCHAR(32)里能榨干唯一索引的性能lastInsertId()必须在事务内、刚 exec 完主表 INSERT 后立即拿否则会被下一条 INSERT 覆盖明细写入直接复用了下单时界面传来的dishName不在这时再去查 MySQL。这样做的原因是菜品价如果在下单过程中被改价历史订单仍保持顾客当时看到的价格。5. QTMySQL 点餐系统避坑指南驱动丢失、中文乱码、平台插件与套接字报错实录5.1 现象QMYSQL driver not loaded程序启动后所有表格都是空的这是新手最常踩的坑也是唯一一个让程序“看起来没坏但就是没数据”的坑。程序能正常打开窗口菜单区空白没有任何报错弹窗。原因Qt 在编译时自带了数据库模块但不一定生成 MySQL 的插件。Windows 上插件是sqldrivers/qsqlmysql.dll它依赖libmysql.dll和libcrypto-3-x64.dll缺任何一个都会被 Qt 静默跳过。验证方法是看 4.1 节里QSqlDatabase::drivers()的输出。解决从你的 Qt 安装目录C:\Qt\5.15.2\msvc2019_64\plugins\sqldrivers复制qsqlmysql.dll到 exe 旁的sqldrivers文件夹再把 MySQL 安装目录的libmysql.dll放进 exe 目录或系统 PATH。如果是开发环境能跑、打包后不能跑优先怀疑这些 dll 没带全。5.2 现象菜品名字存进去变乱码读出来是问号现象很具象在 MySQL Workbench 里看表数据是“宫保鸡丁”程序界面上显示“????????”或者后台存的是“瀹″疂楦″竵”。这种乱码不是我方数据库的问题而是客户端到服务端字符集协商失败。原因QT 的QString内部是 UTF-16和 MySQL 通信时如果连接没设置SET NAMES utf8mb4服务端可能按latin1解释客户端发送来的字节流。另外 MySQL 的utf8在 5.6 之前只是utf8mb3要安全支持全部中文和 emoji必须明确写utf8mb4。解决两处设置必须同时到位。表结构按第 3 章方案建统一CHARSETutf8mb4连接建立后立即执行一条SET NAMES utf8mb4。在 QT 代码里相当于加一句QSqlQuery q(db); q.exec(SET NAMES utf8mb4);如果项目用 Qt 5建议同时在main.cpp开头设置QTextCodec::setCodecForLocale(QTextCodec::codecForName(UTF-8))。虽然这个只在编码转换时生效但能避免QString::fromLocal8Bit在中文 Windows 环境下采用 GBK 解释文件路径和命令行参数。5.3 现象双击 exe 直接崩溃报 cannot mix incompatible qt library (version ex50601) with this library这条报错在“从别的机器拷贝项目/发布软件”时非常常见。典型场景是源代码在 A 电脑能跑打包拷到 B 电脑双击闪退事件查看器里提示 0xc0000005 访问冲突。原因B 电脑 PATH 里存在另一个版本的 Qt 运行库比如系统环境变量先指到了 Qt 5.6.1而当前 exe 是用 Qt 5.15.2 编译的程序加载Qt5Core.dll时版本对不上QT 直接拒绝混用。还有种不太明显的原因是部署时用了windeployqt但把Qt5Core.dll和Qt5Widgets.dll从不同版本的安装目录拷贝出来混着用。解决部署目录里只用一套 Qt 版本启动程序前用dumpbin /dependents Qt5Core.dll确认当前加载的 Qt5Core 的版本号发布目录全部交给windeployqt自动生成不要手动拷贝。另外把 exe 所在目录置顶于PATH环境变量避免程序优先加载系统目录里的旧库。血泪经验不要同时装多个 Qt 版本并全部加入 PATH开发环境很容易就错乱。5.4 现象嵌入式设备上报 could not find the qt platform plugin “linuxfb”这个坑一般在树莓派、安卓工控板上跑程序时出现。命令行启动时输出一长串错误核心是找不到linuxfb平台插件。点餐源码到了 ARM 设备能编译运行却起不来。原因桌面版 Qt 默认只带windows、xcb平台插件linuxfb是在 Linux 帧缓冲设备上运行所需的光栅化插件只有当你交叉编译 Qt 或安装qtbase插件包时才会带上。源码包通常不会附这个插件因为它和编译方式强绑定。解决在交叉编译 Qt 时加上-linuxfb选项如果用的是树莓派官方镜像需要安装libqt5gui5且确认plugins/platforms/libqlinuxfb.so存在。运行前设置环境变量export QT_QPA_PLATFORMlinuxfb export QT_QPA_PLATFORM_PLUGIN_PATH/usr/lib/qt5/plugins/platforms ./OrderSystem如果设备有触摸屏还要让 Qt 感知/dev/input/event*设备常见做法是链接 libts 并设置QT_QPA_FB_TSLIB1。这个坑的本质是Qt 的平台插件不是运行时现找的而是编译期决定的东西换机器就得核对平台插件。5.5 现象MySQL 报 ERROR 2002 (HY000)Cant connect to local MySQL server through socket /tmp/mysql.sock这个报错有时出现在 MySQL 命令行里有时出现在 QT 连接日志里。现象十分统一客户端尝试连接 MySQL但服务端没有应答。原因报错里的关键信息不是端口而是socket /tmp/mysql.sock。当客户端主机名写成localhost时MySQL 客户端库会优先走 Unix 套接字而不是 TCP/IP如果 MySQL 服务没启动套接字文件不存在就报 2002。在 QT 里如果setHostName(localhost)底层驱动同样可能走套接字路径。解决先确认 MySQL 服务真的在运行Linux 下用systemctl status mysqlWindows 下看“服务”里MySQL80是否启动然后把 QT 连接参数里的主机统一写成127.0.0.1而不是localhost强制走 TCP 端口 3306绕开套接字文件。最后检查 MySQL 配置文件里有没有skip-networking1这个参数会直接禁止 TCP 监听导致127.0.0.1也连不上。部署到后厨电脑时我一般把这三项检查写进部署文档免得现场工程师把“服务没启动”误判成“驱动坏了”。6. 验证这套系统值不值得投钱用 QChart 跑一周销量榜回滚测试收尾6.1 用 QChart 装配一周销量 Top5如果源码包自带了QT charts你就有了一份现成的运营数据验证工具。销冠菜品统计是最能检验数据库设计是否合理的查询它要同时访问订单表、明细表、菜品表还对时间字段做聚合。#include QtCharts QChart *chart new QChart(); chart-setTitle(最近 7 天销量 Top5); QBarSeries *series new QBarSeries(); QSqlQuery q(DbManager::instance().database()); q.exec(SELECT d.name AS dish_name, SUM(od.quantity) AS sale_cnt FROM order_detail od JOIN orders o ON od.order_id o.id JOIN dish d ON od.dish_id d.id WHERE o.status 1 AND o.pay_time DATE_SUB(NOW(), INTERVAL 7 DAY) GROUP BY d.name ORDER BY sale_cnt DESC LIMIT 5); QBarSet *set new QBarSet(销量); QStringList categories; while (q.next()) { set-append(q.value(sale_cnt).toDouble()); categories q.value(dish_name).toString(); } series-append(set); chart-addSeries(series); QBarCategoryAxis *axisX new QBarCategoryAxis(); axisX-append(categories); chart-addAxis(axisX, Qt::AlignBottom); series-attachAxis(axisX);这段代码能跑通意味着第 3 章的表结构设计没有原则性错误。DATE_SUB(NOW(), INTERVAL 7 DAY)躲开了凌晨零点清零的边界问题ORDER BY sale_cnt DESC LIMIT 5让数据库只回传五条数据而不是把整月明细搬到 QT 内存里再做排序。6.2 下单回滚验证事务是点餐系统的后悔药进阶验证手段比功能本身更值钱故意在事务中间制造一次失败看系统是否能回滚。做法是临时给菜品表加一条违禁约束比如把某个dish_id指向一个不存在的分类然后下单看createOrder是否返回 false 且订单表不产生半截数据。我现在的习惯是每次接手这类源码先做三十分钟的破坏性测试断网重连、连续双击下单按钮五十次、把数据库表删掉一张再启动。前两个问题大多靠事务和防重复提交解决最后一个问题能直接检验部署文档是否把db/order_system.sql的初始化步骤写清楚了。这套流程跑完你对这个压缩包的判断就不是“界面好不好看”而是“它能不能在真实收银环境下不出错”。希望你照着这个思路检查一遍手头的源码包后能少走我当年踩过的弯路也希望帮到你。本文还有配套的精品资源点击获取 QT+MySQL点餐系统源码解析：从数据库设计到避坑实战
简介一份基于QT与MySQL的点餐系统完整项目源码面向C/QT初学者及需要完成课程设计、毕业设计的高校学生也适合想了解桌面端数据库应用开发的开发者参考。项目围绕餐厅点餐场景将窗口界面、业务逻辑与MySQL数据库连接整合在一起提供完整可编译运行的工程无需修改即可在本地环境部署体验契合高分课设的交付要求。压缩包共18个文件约385KB核心包含4个C源文件、3个头文件、2个QT界面文件以及工程配置文件另有QSS样式表和QRC资源文件负责界面美化与图片素材管理结构完整清晰便于按模块查看和替换素材。资源目前已有644人学习下载适合有C基础、希望快速上手QT数据库开发的读者。拿到后可对照代码学习窗口布局、控件信号槽、数据库连接与增删改查等关键知识点也能直接更换界面图片或样式用于汇报演示省去从零搭建环境和排错时间是课设实战与答辩准备的现成参考。1. 基于 QTMYSQL 的点餐系统源码从驱动跑到前台收银最该先读的是数据库部分真正做过点餐系统的人都有体会QT 界面从来不是最耗时间的最耗时间的是 MySQL 驱动装不上、中文菜名存进去再读出来变成问号、下单时订单主表和明细表没写全月底对账才发现少了两道菜。所谓“基于 QTMYSQL 的点餐系统源码全部资料.zip”通常打包着三样东西Qt Creator 工程、MySQL 建表脚本、界面资源和部署说明。它的价值不是让你学会画一个按钮而是让你在最短时间内看懂一套小型 MIS 系统的骨架排桌、点菜、下单、结账、统计数据怎么流转、哪里容易翻车。想快速跑通毕业设计、接手小饭店收银台或者拿这套结构改造成进销存都可以把这篇当落地说明书用。2. 点餐系统的功能域与 QT/MySQL 选型先把这套源码拆成五个模块再动手2.1 点餐系统的五个功能域与数据流转点餐系统不是一个“大前端页面”它本质上是一个订单管理系统。按下单链路拆功能域会非常清晰菜单管理维护菜品分类、菜名、价格、上下架状态桌台管理桌位编号、容量、占用/空闲状态支持换桌点餐下单选菜、改数量、计算金额生成订单后先落主表再落明细后厨联动多数小型源码不做实时通信而是靠订单状态字段加定时刷新后厨看到新订单就备菜结算统计日结、月结、菜品销量排行直接对订单表和明细表做聚合查询。数据流是单向的QT 界面拿到用户操作包装成 SQL 发给 MySQL再用查询结果刷新界面。QT 本身不承担存储职责所有桌台、菜品、订单状态都以数据库为准。这套架构下“点餐”类项目恰好是 QT 的 Model/View 框架最舒服的场景QTableView只负责显示QSqlQueryModel负责拉数据界面逻辑和数据访问逻辑长时间不会互相污染。2.2 为什么常见方案都选 QT Widgets MySQL而不是 QML / SQLite很多新手第一次解压这类源码会嫌弃界面“老气”。原因不是作者审美差而是点餐系统的使用场景大多是 Windows 收银机、嵌入式触摸屏要求低资源占用、键盘鼠标协同操作、长时间不崩溃。QML 做酷炫动画和触屏交互很在行但收银台需要焦点快速跳转、表格批量编辑、弹窗输密码这些用QWidget配QTableView、QLineEdit、QDialog更成熟保守出问题了也能从海量历史资料里找到答案。数据库选型上SQLite 不是不能跑但点餐系统一旦出现前厅点菜、后厨确认、老板查报表同时发生的场景SQLite 的写锁会直接卡住整个业务。MySQL 的 InnoDB 引擎提供行级锁、事务、崩溃恢复对这类多终端小型系统来说属于必需基础。需要留意的是 MySQL 5.7 和 8.0 的差异新的 QT 驱动和 libmysql 动态库基本都适配 8.x但老源码里如果写着mysql_native_password相关配置在 MySQL 8 默认caching_sha2_password下可能报认证错误这个坑我会在第 5 章单独展开。2.3 “全部资料”里的典型结构先找到 .pro、db 脚本、res 目录“全部资料”四个字虽然不属于任何官方命名但这类压缩包解压后百分之七八十是下面这个骨架OrderSystem/ ├── OrderSystem.pro # qmake 工程文件Qt 版本和模块在这里声明 ├── db/ │ ├── order_system.sql # 建库建表 初始化数据脚本 │ └── 数据库说明.txt # 账号、密码、字符集、版本要求 ├── src/ │ ├── main.cpp │ ├── mainwindow.ui # 主窗体布局XML 描述 │ ├── dlg_login.ui # 登录窗口 │ ├── dbmanager.h/cpp # QSqlDatabase 封装通常做单例 │ └── xxxwidget.h/cpp # 各功能模块界面逻辑 ├── res/ │ ├── icons/ # 菜品图、按钮图标 │ └── qss/ # 样式表 ├── build/ # 有些包会连带编译产物一起发 └── 部署说明.md拿到压缩包先别急着双击 exe按顺序确认三件事第一db/order_system.sql能不能在目标 MySQL 里完整执行第二Qt 编译产物旁边有没有sqldrivers目录下的qsqlmysql.dll或libqsqlmysql.so这决定程序能不能真正连上 MySQL第三res/icons里的图片来源是不是写了绝对路径很多项目复制到别人电脑后图片加载不出来就是代码里写死了C:/Users/xxx/Desktop/...这种地址。2.4 拿到压缩包之后的三个动作灌库、装 Qt 5.15.2、改连接参数如果你是从零接手一个“QTMYSQL 点餐系统源码包”我的习惯动作是三步先用 MySQL Workbench 或者命令行把 SQL 脚本整库跑一遍确认表都建出来了再从 Qt 官网装一个与.pro文件匹配的版本常见写法是QT core gui sql如果里面带charts就需要装带charts模块的安装包最后打开dbmanager或main.cpp里写死的那行连接参数改成自己本机的库名、用户、密码。这里补一句版本建议如果源码是在 Qt 5.15 下写的我一般不会硬着头皮升 Qt 6因为QT sql之外还有webenginewidgets、charts等模块在 Qt 6 里变动很大强行编译只会浪费几个小时在无关错误上。先把 5.15.2 跑通把业务验证完再评估升级 Qt 6 的成本这个顺序最省钱。3. MySQL 表设计是整套系统的心脏建表、初始化数据与事务落地3.1 五张核心表的关系与字段设计点餐系统的表不一定多但每一张都承担明确职责。典型设计最少五张表分类表category、菜品表dish、桌台表dining_table、订单主表orders、订单明细表order_detail。我见过一些非正规源码把菜品分类直接塞在菜品表里用字符串存短期能跑但你想改分类名、按分类统计销量时就会非常痛苦。CREATE DATABASE IF NOT EXISTS order_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE order_system; CREATE TABLE category ( id INT NOT NULL AUTO_INCREMENT, name VARCHAR(50) NOT NULL COMMENT 分类名称如热菜/凉菜/饮品, sort_order INT NOT NULL DEFAULT 0 COMMENT 排序权重小的排前面, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE dish ( id INT NOT NULL AUTO_INCREMENT, category_id INT NOT NULL, name VARCHAR(100) NOT NULL COMMENT 菜名, price DECIMAL(10,2) NOT NULL DEFAULT 0.00 COMMENT 零售价, status TINYINT NOT NULL DEFAULT 1 COMMENT 1上架 0下架, image VARCHAR(255) DEFAULT NULL, PRIMARY KEY (id), KEY idx_category (category_id), CONSTRAINT fk_dish_category FOREIGN KEY (category_id) REFERENCES category (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;两点参数说明一是价格用DECIMAL(10,2)绝不用FLOAT否则精确计算金额时会出现 0.1 0.2 0.30000000000000004 之类的浮点误差二是字符集统一utf8mb4它比utf8多支持 emoji 和生僻字菜名里有“”这种字也不会崩。外键这里我只在dish→category上加订单相关的外键下一节给因为外键会影响写入性能要在点餐系统里平衡使用。3.2 初始化数据与字符集utf8mb4、DEFAULT 0、排序规则建表之后必须有一批初始数据否则程序一启动菜单区就是空的界面看起来就像死机。初始化脚本常见写法是把分类和菜品直接 INSERT再给桌台生成 10 或 20 个座位记录INSERT INTO category (name, sort_order) VALUES (热菜, 1), (凉菜, 2), (主食, 3), (饮品, 4); INSERT INTO dish (category_id, name, price, status) VALUES (1, 宫保鸡丁, 28.00, 1), (1, 水煮鱼, 68.00, 1), (2, 凉拌黄瓜, 16.00, 1), (3, 米饭, 3.00, 1); INSERT INTO dining_table (table_no, seat_count, status) VALUES (A001, 4, 0), (A002, 4, 0), (A003, 6, 0), (B001, 8, 0), (B002, 10, 0);这里跟着热搜词走一个小细节mysql 设置默认值为 0在点餐系统里非常常用。桌台status默认 0意思是“空闲”下单成功后由程序改成 1菜品status默认 1意思是“上架”。一张 TINYINT 字段用 0/1 表示状态比用字符“空闲/占用”更省空间也更好写 WHERE。唯一要注意的是接口层必须做注释不然三个月后你自己都不知道status0是空闲还是下架。sort_order字段建议保留它解决“分类顺序总是乱跳”的问题。很多源码表里根本没有这个字段菜单顺序完全依赖 INSERT 顺序一旦删过数据顺序就乱了。有sort_order之后ORDER BY sort_order, id就能稳定复现人工排好的顺序。3.3 下单事务与存储过程订单和明细不能分两步提交点餐系统最大的逻辑风险是用户点了五个菜界面提示下单成功但数据库订单明细表里只有四个菜。这种事故几乎都是因为“先插订单主表再插明细表”之间没有任何事务保护。事务的意义不是让你的 SQL 变快而是让多条 SQL 语句要么全部成功要么全部失败。START TRANSACTION; INSERT INTO orders (table_id, order_no, total_amount, status) VALUES (1, 20250608120000123, 0, 0); SET order_id LAST_INSERT_ID(); INSERT INTO order_detail (order_id, dish_id, dish_name, price, quantity, amount) VALUES (order_id, 1, 宫保鸡丁, 28.00, 2, 56.00), (order_id, 2, 水煮鱼, 68.00, 1, 68.00), (order_id, 4, 米饭, 3.00, 2, 6.00); UPDATE dining_table SET status 1 WHERE id 1; COMMIT;LAST_INSERT_ID()是这条事务里最值得记住的函数它返回当前连接上一次 INSERT 产生的自增主键而且天然是“会话级安全”的两个客户端同时下单也不会互相拿到对方的 ID。如果把整个下单流程封装成 MySQL 存储过程比如CALL sp_create_order(1, ...)客户端就只需要一行调用代码这种方案在源码包里也经常见到适合网络环境不稳、防止逻辑被客户改坏的场景DELIMITER $$ CREATE PROCEDURE sp_create_order(IN p_table_id INT, IN p_order_no VARCHAR(32)) BEGIN DECLARE v_order_id BIGINT; START TRANSACTION; INSERT INTO orders (table_id, order_no) VALUES (p_table_id, p_order_no); SET v_order_id LAST_INSERT_ID(); -- 明细表的写入由调用方逐条传入这里只演示骨架 COMMIT; END$$ DELIMITER ;事务还有个隐藏价值它是点餐系统的“后悔药”。结账时发现用户退菜不能真的把明细 DELETE 掉而是另一条状态为负数的冲正明细。有了事务退菜和冲正就能在同一事务里完成不会出现退菜成功、金额没减的半吊子状态。4. 用 QT 把 MySQL 跑通的最小代码驱动检查、单例封装、菜单加载与下单事务4.1 先查驱动再写连接QMYSQL driver not loaded 是第一道坎很多源码包在你本机编译一次通过拷到别的电脑就变成QSqlDatabase: QMYSQL driver not loaded。原因是 Qt 的 MySQL 插件是动态库插件默认安装时不一定带上或者运行时找不到。所以写任何连接代码之前先做驱动自检#include QSqlDatabase #include QDebug int main(int argc, char *argv[]) { // 程序启动第一件事确认 MySQL 驱动是否存在 QStringList drivers QSqlDatabase::drivers(); qDebug() 当前可用的数据库驱动: drivers; if (!QSqlDatabase::isDriverAvailable(QMYSQL)) { qCritical() QMYSQL driver not loaded后续所有数据库操作都会失败; return -1; } return 0; }QSqlDatabase::drivers()返回的是当前插件目录下所有可用驱动名看到QMYSQL才算过关。一个小概率情况是驱动在但在错误路径Qt 的sqldrivers插件必须和libmysql.dll放在一起程序才能加载。如果自检输出里只有QSQLITE需要重新安装带 MySQL 插件的 Qt或者从另一台同版本 Qt 的plugins/sqldrivers目录里拷贝qsqlmysql.dll。4.2 数据连接单例封装配置写入 config.ini换电脑不重新编译源码包里最常见的连接错误就是把 root 密码写死在代码里。正确的做法是读外部配置文件这样部署到后厨电脑时只需要改 ini 文件不需要重新编译。单例封装的写法// dbmanager.h #pragma once #include QSqlDatabase class DbManager { public: static DbManager instance(); QSqlDatabase database(); bool open(); private: DbManager(); QSqlDatabase m_db; };// dbmanager.cpp #include dbmanager.h #include QSqlError #include QSettings #include QVariant DbManager DbManager::instance() { static DbManager inst; // C11 局部静态变量线程安全 return inst; } DbManager::DbManager() { // config.ini 放在 exe 同目录方便现场工程师直接改 QSettings config(config.ini, QSettings::IniFormat); m_db QSqlDatabase::addDatabase(QMYSQL, order_conn); m_db.setHostName(config.value(mysql/host, 127.0.0.1).toString()); m_db.setPort(config.value(mysql/port, 3306).toInt()); m_db.setDatabaseName(config.value(mysql/dbname, order_system).toString()); m_db.setUserName(config.value(mysql/user, root).toString()); m_db.setPassword(config.value(mysql/pass, ).toString()); } bool DbManager::open() { if (!m_db.open()) { qCritical() 数据库打开失败 m_db.lastError().text(); return false; } return true; } QSqlDatabase DbManager::database() { return m_db; }注意这里QSqlDatabase::addDatabase(QMYSQL, order_conn)给了连接一个名字而不是用默认连接。多并发窗口操作时每个查询拿同一个 connection 名会互相干扰如果源码里需要开多个连接用不同名字注册即可。另外打开失败时最好打印lastError().text()它会直接告诉你Access denied for user还是Cant connect to MySQL server这比猜原因快得多。4.3 用 QSqlQueryModel 把菜品表搬到 QTableView菜单窗口的本质是“SELECT 一张表显示在表格里”。用QSqlQueryModel最直接void MainWindow::loadMenu() { // 查询上架菜品按分类排好 QSqlQueryModel *model new QSqlQueryModel(this); QString sql SELECT d.id, c.name AS category, d.name AS dish_name, d.price FROM dish d JOIN category c ON d.category_id c.id WHERE d.status 1 ORDER BY c.sort_order, d.id; model-setQuery(sql, DbManager::instance().database()); if (model-lastError().isValid()) { QMessageBox::critical(this, 加载菜单失败, model-lastError().text()); return; } model-setHeaderData(0, Qt::Horizontal, 菜品ID); model-setHeaderData(1, Qt::Horizontal, 分类); model-setHeaderData(2, Qt::Horizontal, 菜名); model-setHeaderData(3, Qt::Horizontal, 价格); ui-tableViewMenu-setModel(model); ui-tableViewMenu-setColumnWidth(2, 180); // 菜名列宽一点中文不换行 ui-tableViewMenu-horizontalHeader()-setStretchLastSection(true); }这里有两层逻辑值得说明。第一直接JOIN category拿分类名而不是在 QT 代码里再查一次分类表一次 SQL 解决显示问题网络往返少一次。第二QSqlQueryModel是只读模型适合展示菜单如果要做“双击菜品加购”这类交互通常是在selectionModel()上连接信号槽拿当前行数据而不是直接改模型。setQuery的第二个参数必须传已经 open 的数据库对象否则模型不知道去哪条连接查询。4.4 下单事务一次点餐写三张表的正确姿势下单是点餐系统唯一的“写多读少”操作一次点击要同时写订单主表、订单明细表、更新桌台状态。QT 里用QSqlDatabase::transaction()包住这三步保证中途任何一步失败都能整体回滚bool OrderService::createOrder(int tableId, const QVectorOrderItem items) { QSqlDatabase db DbManager::instance().database(); db.transaction(); QSqlQuery q(db); q.prepare(INSERT INTO orders (table_id, order_no, total_amount, status) VALUES (:table_id, :order_no, :total_amount, 0)); QString orderNo QDateTime::currentDateTime().toString(yyyyMMddhhmmsszzz); double total 0.0; for (const OrderItem item : items) { total item.price * item.quantity; } q.bindValue(:table_id, tableId); q.bindValue(:order_no, orderNo); q.bindValue(:total_amount, total); if (!q.exec()) { db.rollback(); qCritical() 写订单主表失败 q.lastError().text(); return false; } QVariant orderId q.lastInsertId(); for (const OrderItem item : items) { QSqlQuery qd(db); qd.prepare(INSERT INTO order_detail (order_id, dish_id, dish_name, price, quantity, amount) VALUES (:order_id, :dish_id, :dish_name, :price, :quantity, :amount)); qd.bindValue(:order_id, orderId); qd.bindValue(:dish_id, item.dishId); qd.bindValue(:dish_name, item.dishName); qd.bindValue(:price, item.price); qd.bindValue(:quantity, item.quantity); qd.bindValue(:amount, item.price * item.quantity); if (!qd.exec()) { db.rollback(); qCritical() 写订单明细失败 qd.lastError().text(); return false; } } QSqlQuery ut(db); ut.prepare(UPDATE dining_table SET status 1 WHERE id :table_id); ut.bindValue(:table_id, tableId); if (!ut.exec()) { db.rollback(); return false; } if (!db.commit()) { db.rollback(); return false; } return true; }参数说明上有三个细节订单号orderNo用yyyyMMddhhmmsszzz生成14 位字符串这种一串数字放满汉字的VARCHAR(32)里能榨干唯一索引的性能lastInsertId()必须在事务内、刚 exec 完主表 INSERT 后立即拿否则会被下一条 INSERT 覆盖明细写入直接复用了下单时界面传来的dishName不在这时再去查 MySQL。这样做的原因是菜品价如果在下单过程中被改价历史订单仍保持顾客当时看到的价格。5. QTMySQL 点餐系统避坑指南驱动丢失、中文乱码、平台插件与套接字报错实录5.1 现象QMYSQL driver not loaded程序启动后所有表格都是空的这是新手最常踩的坑也是唯一一个让程序“看起来没坏但就是没数据”的坑。程序能正常打开窗口菜单区空白没有任何报错弹窗。原因Qt 在编译时自带了数据库模块但不一定生成 MySQL 的插件。Windows 上插件是sqldrivers/qsqlmysql.dll它依赖libmysql.dll和libcrypto-3-x64.dll缺任何一个都会被 Qt 静默跳过。验证方法是看 4.1 节里QSqlDatabase::drivers()的输出。解决从你的 Qt 安装目录C:\Qt\5.15.2\msvc2019_64\plugins\sqldrivers复制qsqlmysql.dll到 exe 旁的sqldrivers文件夹再把 MySQL 安装目录的libmysql.dll放进 exe 目录或系统 PATH。如果是开发环境能跑、打包后不能跑优先怀疑这些 dll 没带全。5.2 现象菜品名字存进去变乱码读出来是问号现象很具象在 MySQL Workbench 里看表数据是“宫保鸡丁”程序界面上显示“????????”或者后台存的是“瀹″疂楦″竵”。这种乱码不是我方数据库的问题而是客户端到服务端字符集协商失败。原因QT 的QString内部是 UTF-16和 MySQL 通信时如果连接没设置SET NAMES utf8mb4服务端可能按latin1解释客户端发送来的字节流。另外 MySQL 的utf8在 5.6 之前只是utf8mb3要安全支持全部中文和 emoji必须明确写utf8mb4。解决两处设置必须同时到位。表结构按第 3 章方案建统一CHARSETutf8mb4连接建立后立即执行一条SET NAMES utf8mb4。在 QT 代码里相当于加一句QSqlQuery q(db); q.exec(SET NAMES utf8mb4);如果项目用 Qt 5建议同时在main.cpp开头设置QTextCodec::setCodecForLocale(QTextCodec::codecForName(UTF-8))。虽然这个只在编码转换时生效但能避免QString::fromLocal8Bit在中文 Windows 环境下采用 GBK 解释文件路径和命令行参数。5.3 现象双击 exe 直接崩溃报 cannot mix incompatible qt library (version ex50601) with this library这条报错在“从别的机器拷贝项目/发布软件”时非常常见。典型场景是源代码在 A 电脑能跑打包拷到 B 电脑双击闪退事件查看器里提示 0xc0000005 访问冲突。原因B 电脑 PATH 里存在另一个版本的 Qt 运行库比如系统环境变量先指到了 Qt 5.6.1而当前 exe 是用 Qt 5.15.2 编译的程序加载Qt5Core.dll时版本对不上QT 直接拒绝混用。还有种不太明显的原因是部署时用了windeployqt但把Qt5Core.dll和Qt5Widgets.dll从不同版本的安装目录拷贝出来混着用。解决部署目录里只用一套 Qt 版本启动程序前用dumpbin /dependents Qt5Core.dll确认当前加载的 Qt5Core 的版本号发布目录全部交给windeployqt自动生成不要手动拷贝。另外把 exe 所在目录置顶于PATH环境变量避免程序优先加载系统目录里的旧库。血泪经验不要同时装多个 Qt 版本并全部加入 PATH开发环境很容易就错乱。5.4 现象嵌入式设备上报 could not find the qt platform plugin “linuxfb”这个坑一般在树莓派、安卓工控板上跑程序时出现。命令行启动时输出一长串错误核心是找不到linuxfb平台插件。点餐源码到了 ARM 设备能编译运行却起不来。原因桌面版 Qt 默认只带windows、xcb平台插件linuxfb是在 Linux 帧缓冲设备上运行所需的光栅化插件只有当你交叉编译 Qt 或安装qtbase插件包时才会带上。源码包通常不会附这个插件因为它和编译方式强绑定。解决在交叉编译 Qt 时加上-linuxfb选项如果用的是树莓派官方镜像需要安装libqt5gui5且确认plugins/platforms/libqlinuxfb.so存在。运行前设置环境变量export QT_QPA_PLATFORMlinuxfb export QT_QPA_PLATFORM_PLUGIN_PATH/usr/lib/qt5/plugins/platforms ./OrderSystem如果设备有触摸屏还要让 Qt 感知/dev/input/event*设备常见做法是链接 libts 并设置QT_QPA_FB_TSLIB1。这个坑的本质是Qt 的平台插件不是运行时现找的而是编译期决定的东西换机器就得核对平台插件。5.5 现象MySQL 报 ERROR 2002 (HY000)Cant connect to local MySQL server through socket /tmp/mysql.sock这个报错有时出现在 MySQL 命令行里有时出现在 QT 连接日志里。现象十分统一客户端尝试连接 MySQL但服务端没有应答。原因报错里的关键信息不是端口而是socket /tmp/mysql.sock。当客户端主机名写成localhost时MySQL 客户端库会优先走 Unix 套接字而不是 TCP/IP如果 MySQL 服务没启动套接字文件不存在就报 2002。在 QT 里如果setHostName(localhost)底层驱动同样可能走套接字路径。解决先确认 MySQL 服务真的在运行Linux 下用systemctl status mysqlWindows 下看“服务”里MySQL80是否启动然后把 QT 连接参数里的主机统一写成127.0.0.1而不是localhost强制走 TCP 端口 3306绕开套接字文件。最后检查 MySQL 配置文件里有没有skip-networking1这个参数会直接禁止 TCP 监听导致127.0.0.1也连不上。部署到后厨电脑时我一般把这三项检查写进部署文档免得现场工程师把“服务没启动”误判成“驱动坏了”。6. 验证这套系统值不值得投钱用 QChart 跑一周销量榜回滚测试收尾6.1 用 QChart 装配一周销量 Top5如果源码包自带了QT charts你就有了一份现成的运营数据验证工具。销冠菜品统计是最能检验数据库设计是否合理的查询它要同时访问订单表、明细表、菜品表还对时间字段做聚合。#include QtCharts QChart *chart new QChart(); chart-setTitle(最近 7 天销量 Top5); QBarSeries *series new QBarSeries(); QSqlQuery q(DbManager::instance().database()); q.exec(SELECT d.name AS dish_name, SUM(od.quantity) AS sale_cnt FROM order_detail od JOIN orders o ON od.order_id o.id JOIN dish d ON od.dish_id d.id WHERE o.status 1 AND o.pay_time DATE_SUB(NOW(), INTERVAL 7 DAY) GROUP BY d.name ORDER BY sale_cnt DESC LIMIT 5); QBarSet *set new QBarSet(销量); QStringList categories; while (q.next()) { set-append(q.value(sale_cnt).toDouble()); categories q.value(dish_name).toString(); } series-append(set); chart-addSeries(series); QBarCategoryAxis *axisX new QBarCategoryAxis(); axisX-append(categories); chart-addAxis(axisX, Qt::AlignBottom); series-attachAxis(axisX);这段代码能跑通意味着第 3 章的表结构设计没有原则性错误。DATE_SUB(NOW(), INTERVAL 7 DAY)躲开了凌晨零点清零的边界问题ORDER BY sale_cnt DESC LIMIT 5让数据库只回传五条数据而不是把整月明细搬到 QT 内存里再做排序。6.2 下单回滚验证事务是点餐系统的后悔药进阶验证手段比功能本身更值钱故意在事务中间制造一次失败看系统是否能回滚。做法是临时给菜品表加一条违禁约束比如把某个dish_id指向一个不存在的分类然后下单看createOrder是否返回 false 且订单表不产生半截数据。我现在的习惯是每次接手这类源码先做三十分钟的破坏性测试断网重连、连续双击下单按钮五十次、把数据库表删掉一张再启动。前两个问题大多靠事务和防重复提交解决最后一个问题能直接检验部署文档是否把db/order_system.sql的初始化步骤写清楚了。这套流程跑完你对这个压缩包的判断就不是“界面好不好看”而是“它能不能在真实收银环境下不出错”。希望你照着这个思路检查一遍手头的源码包后能少走我当年踩过的弯路也希望帮到你。本文还有配套的精品资源点击获取