C++ 聊天室项目：Linux 环境搭建与问题总结

本文记录 C++ 在线聊天室项目的环境部署流程、核心依赖配置与实战踩坑总结，适用于同类型前后端项目环境搭建参考。

一、环境部署流程

1. 基础服务安装

项目依赖 MySQL、Redis、Node.js 环境，执行一键安装命令：

# 安装数据库与缓存服务
sudo apt install mysql-server redis-server -y
# 安装Node.js（前端运行依赖）
sudo apt install nodejs npm -y

2. 启动核心服务

# 启动MySQL（用户登录、数据存储）
sudo systemctl start mysql
# 后台启动Redis（会话管理、WebSocket通信）
redis-server --daemonize yes
# 查看服务运行状态
ps aux | grep mysql
ps aux | grep redis

3. 后端编译与启动

# 进入项目构建目录
cd server/build
# 编译项目
make
# 启动后端服务
./bin/chat-room1 chat-room.conf

4. 前端部署启动

# 进入前端目录
cd client/web
# 安装项目依赖
npm install
# 启动前端项目
npm run dev

二、核心知识点

1. JSON 序列化作用

项目前后端通信核心技术：

• 序列化：C++ 对象 → JSON 字符串，用于网络传输
• 反序列化：JSON 字符串 → C++ 对象，用于逻辑处理
• 应用场景：用户登录、聊天消息收发、数据持久化

2. Cookie 与会话

Cookie 是浏览器的身份标识，项目中用于：

• 保持用户登录状态
• 识别 WebSocket 连接用户
• 浏览器自动携带，无需手动配置

三、实际问题总结

1. **后端崩溃（malloc 内存错误）**原因：连接异常导致内存越界，解决方案：重启后端服务。
2. **npm 启动报错（ENOSPC）**原因：虚拟机磁盘空间不足，解决方案：清理缓存、扩容磁盘。
3. 内存占用过高原因：主机程序过多 + 虚拟机内存分配不合理，解决方案：关闭后台程序，优化虚拟机内存分配（ 如4G）。
4. 服务无法连接原因：Redis/MySQL 未启动，解决方案：按顺序启动基础服务。

四、项目正常启动流程

# 1. 启动基础服务
sudo systemctl start mysql
redis-server --daemonize yes
# 2. 启动后端
cd server/build && ./bin/chat-room1 chat-room.conf
# 3. 启动前端
cd client/web && npm run dev

---

https://github.com/0voice