当前位置：首页 > news >正文

Qt 网络聊天室项目

news 2025/10/29 7:11:20

项目视频演示：点这里
项目源码：点这里

项目概述

项目定位

基于 Qt 框架开发的多人实时网络聊天室，旨在实现稳定、易用的跨平台即时通信功能，满足小型团队或内部协作的沟通需求。

核心目标

支持20 人客户端同时在线
实现用户身份验证与账户管理
在聊天室可以进行群聊
提供聊天历史记录存储与查询
生成持久化的log日志
生成可直接部署的安装包，降低使用门槛

核心功能模块

功能模块	实现要点	技术支撑
1. 用户登录与账户管理	- 支持账号注册（检测账号唯一性）- 支持账号登录（密码验证）- 账户数据持久化存储	SQLite 数据库（account 表）、Qt SQL
2. 多人实时聊天	- 实时接收 / 发送消息- 消息携带日期 + 时间戳（格式：yyyy/MM/dd hh/mm）- 全员消息广播	Qt Network（TCP）、多线程
3. 聊天历史记录	- 自动存储所有聊天消息- 支持关键词模糊查询（如 “会议”“文件”）- 查询结果可视化展示	SQLite 数据库（history 表）、字符串匹配
4. 界面交互优化	- 登录 / 注册按钮状态联动（空输入时禁用）- 发送 / 查询按钮动态启用（非空输入触发）- 弹窗提示操作结果（如 “注册成功”“密码错误”）	Qt Widgets、信号与槽机制

技术架构

技术栈选型

技术领域	具体组件 / 工具	作用说明
开发框架	Qt 5.x（推荐 5.4+）	提供 UI、网络、数据库、线程的一站式支持
网络通信	Qt Network（QTcpServer/QTcpSocket）	基于 TCP 协议实现客户端 - 服务器双向通信
数据存储	SQLite 数据库	本地轻量数据库，存储账户（account）与历史记录（history）
线程处理	QThread + Worker 线程	分离网络通信与 UI 渲染，避免界面卡顿
打包工具	Inno Setup Compiler + windeployqt	补充动态链接库、生成 Windows 安装包

架构流程图（示意）

客户端（Dialog登录页 → ChatRoom聊天页） ↕（TCP通信）
服务器端（QTcpServer → 多客户端管理）↕（数据读写）
SQLite数据库（account表 + history表）

核心代码实现（关键模块）

数据库模块（database.cpp）

账户与历史记录的增删改查

数据库初始化

：自动创建
```
clientInfo.db
```
，若成功则生成 2 张核心表：
- account表：字段（id - 自增主键，account - 账号，pswd - 密码）
- history表：字段（id - 自增主键，msg - 聊天消息（含时间戳））

关键接口示例

// 登录验证（返回0=成功，-1=账号不存在，-2=密码错误）
int DataBase::login_accountTable(QString account, QString pswd) {if (!isAccountExist(account)) return -1;QString sql = "SELECT pswd FROM account WHERE account=?";// 预处理SQL，避免注入风险QSqlQuery sq;sq.prepare(sql);sq.addBindValue(account);// ... 密码比对逻辑 ...
}// 插入聊天记录
void DataBase::insertData_historyTable(QString msg) {QString sql = "INSERT INTO history(msg) VALUES(:msg)";QSqlQuery sq;sq.prepare(sql);sq.bindValue(":msg", msg); // 消息格式：“2025/07/08 16:33\n张三说：大家好”sq.exec();
}

网络通信模块（network.cpp）

核心功能：服务器端连接管理与消息分发

服务端初始化

：监听 8887 端口，接收客户端连接请求：

void Network::initServer() {server = new QTcpServer(this);bool ret = server->listen(QHostAddress::Any, 8887);if (ret) {emit progressUpdate(ProgressReport::listenSucceed); // 通知UI监听成功connect(server, SIGNAL(newConnection()), this, SLOT(newConnection_slot()));} else {emit progressUpdate(ProgressReport::listenErr);}
}

消息处理逻辑：按协议解析客户端数据（如 “login | 账号 | 密码”“send | 时间 | 消息”），分发至对应处理函数（登录 / 注册 / 消息广播 / 历史查询）。

UI 交互模块（chatroom.cpp/dialog.cpp）

登录界面（Dialog）：实现账号 / 密码输入、注册 / 登录按钮切换，空输入时弹窗警告。
聊天界面（ChatRoom）
- 发送按钮：输入非空时启用，发送消息自动携带时间戳。
- 查询按钮：输入关键词时启用，查询结果在 “历史记录” 面板展示。
- 消息展示：接收的全员消息实时追加至 “聊天面板”，格式清晰。

总结与拓展

项目亮点