TCP/IP协议栈实现简易聊天系统开发实践
1. 项目背景与会议核心内容复盘
作为软件工程专业计算机网络课程的首次实践项目，我们团队在项目启动阶段召开了长达3小时的线上协作会议。这次会议主要解决了三个关键问题：首先是明确了项目将以"基于TCP/IP协议栈的简易聊天系统"作为核心开发目标；其次是根据成员技术栈完成了模块分工；最后制定了包含5个里程碑节点的开发路线图。
会议中特别讨论了三个技术争议点：
- 传输层协议选择（最终确定TCP协议）
- 消息编码格式（采用JSON而非XML）
- 心跳机制实现方案（应用层自行实现）
关键决策依据：TCP的可靠传输特性更适合聊天场景，JSON的轻量级特性在短消息传输中更具优势，而应用层心跳可以避免NAT超时导致的连接中断。
2. 技术方案与任务分解
2.1 系统架构设计
采用C/S架构，服务端使用Python的socket模块实现，客户端考虑跨平台需求选择Electron框架。整个系统包含以下核心模块：
- 连接管理模块（含断线重连）
- 消息编解码模块
- 用户状态管理
- 简易GUI界面
2.2 开发任务分配
根据团队成员的技术背景，我们做了如下分工：
| 成员 | 负责模块 | 技术栈 | 交付时间 |
|---|---|---|---|
| 张三 | 服务端核心逻辑 | Python | 第3周 |
| 李四 | 客户端GUI | Electron | 第4周 |
| 王五 | 网络通信协议封装 | C++ | 第2周 |
| 赵六 | 测试用例开发 | pytest | 第5周 |
3. 开发环境与工具链配置
3.1 基础环境搭建
统一要求所有成员使用VS Code作为开发IDE，并安装以下必备插件：
- Python Extension Pack
- ESLint
- Docker（用于环境隔离）
版本控制采用Git Flow工作流，在GitLab上建立了以下分支：
- master（保护分支）
- develop（集成分支）
- feature/*（功能开发分支）
3.2 联调测试方案
我们设计了三级测试体系：
- 单元测试（模块内部）
- 集成测试（模块间通信）
- 压力测试（JMeter模拟100并发）
测试用例覆盖率要求不低于80%，关键路径必须达到100%。
4. 项目进度管理与风险控制
4.1 里程碑节点
制定了下述关键节点及交付物：
- 第1周：完成协议设计文档（含报文格式定义）
- 第2周：实现基础通信框架
- 第3周：完成核心功能开发
- 第4周：GUI界面联调
- 第5周：系统测试与优化
4.2 风险应对预案
针对可能出现的三大风险制定了应对措施：
- 网络延迟问题：采用消息队列缓冲+ACK确认机制
- 跨平台兼容性：在CI流程中加入多平台构建测试
- 并发性能瓶颈：预先设计连接池方案
5. 协作规范与质量要求
5.1 代码规范
严格执行PEP8标准，重点强调：
- 函数注释必须包含参数说明和返回值类型
- 禁止使用全局变量
- 异常处理必须记录到日志文件
5.2 文档要求
每个模块需要配套以下文档：
- 接口说明文档（Swagger格式）
- 部署手册（含环境依赖说明）
- 用户操作指南（图文版）
6. 常见问题解决方案
在实际开发过程中，我们预见到可能会遇到以下典型问题：
粘包问题：
- 解决方案：采用固定头部长度的协议设计
- 实现示例：
def send_msg(sock, msg): # 添加4字节长度头 header = struct.pack('!I', len(msg)) sock.sendall(header + msg.encode())
端口占用冲突：
- 快速排查命令：
netstat -ano | findstr 8080
- 快速排查命令：
跨平台编码问题：
- 统一要求使用UTF-8编码
- 在文件头显式声明：
# -*- coding: utf-8 -*-
7. 后续行动计划
根据会议讨论结果，我们制定了详细的后续执行计划：
本周重点：
- 完成开发环境统一配置
- 建立CI/CD流水线
- 产出协议设计初稿
沟通机制：
- 每日站会（早9:00，15分钟）
- 每周迭代会议（周五晚7点）
- 紧急问题通过Slack@here通知
质量检查点：
- 代码review必须在合并前完成
- 重要变更需要双人复核
- 每周生成SonarQube质量报告