常见问题
常见问题概览
安装和配置
Q: 如何安装 RushChat？
A: 请查看 安装指南 获取详细的安装步骤。
Q: 数据库连接失败怎么办？
A: 检查以下几点：
- 确保 MySQL 正在运行
- 检查 .env 文件中的数据库凭据
- 验证数据库是否存在：mysql -u root -p -e "SHOW DATABASES;"
- 检查数据库用户权限
Q: 端口已被占用怎么办？
A:
- 在 .env 文件中更改 PORT
- 更新客户端中的 REACT_APP_SOCKET_URL
- 或者停止占用端口的进程
Q: CORS 错误怎么解决？
A:
- 检查后端 CLIENT_URL 环境变量
- 确保前端地址包含协议（http:// 或 https://）
- 确保生产环境使用 HTTPS
使用问题
Q: 如何注册账户？
A: 1. 点击"注册"按钮 2. 填写用户名（3-20个字符）、密码（至少6个字符）、邮箱（可选） 3. 点击"注册"
Q: 如何创建频道？
A: 1. 点击左侧频道列表的"+"按钮 2. 输入频道名称 3. 选择"公共频道"或"私密频道" 4. 如果是私密频道，设置密码 5. 点击"创建"
注意： - 普通用户需要 10 万积分，创建消耗 5 万积分 - Rush高管免费创建，不消耗积分
Q: 如何上传表情包？
A: 1. 点击输入框右侧的表情图标 2. 选择"我的表情"标签 3. 点击"上传表情包" 4. 选择 GIF 文件（最大 5MB）
限制： - 普通用户最多 10 个 - 管理员和房主最多 100 个
Q: 如何邀请朋友？
A: 1. 点击右上角用户头像 2. 选择"邀请" 3. 复制邀请链接或生成二维码 4. 分享给朋友
奖励： - 成功邀请注册用户，邀请人获得 10,000 积分和 5 频道贡献值
功能问题
Q: 什么是游客模式？
A: 游客模式允许用户无需注册即可进入聊天室，但只能观看，不能发言或上传图片。
Q: 什么是保留字保护？
A: 以下用户名必须使用密码登录，不能以游客身份使用： - admin, root, administrator, system, moderator, mod, superadmin, super, owner, manager
Q: 如何成为管理员？
A: 管理员由高级管理员任命，不能自行申请。
Q: 积分如何获取？
A: - 注册奖励 - Build 激励（每日可领取 1000 积分） - 邀请奖励（成功邀请注册用户获得 10,000 积分） - 频道贡献（通过邀请链接注册的用户，邀请人获得 5 频道贡献值）
Q: 荣誉等级如何计算？
A: 荣誉等级根据总积分自动计算，评分机制包括： - 在线时长：每在线 60 分钟 = 1 分 - 邀请人数：每成功邀请 1 人 = 10 分 - 消息数量：每发送 100 条消息 = 1 分 - 消息点赞：每个点赞 = 2 分 - 合约推荐：每推荐 1 个合约 = 5 分 - 推荐评分：平均投票分数 × 10
技术问题
Q: WebSocket 连接失败怎么办？
A:
- 检查前端 REACT_APP_SOCKET_URL 是否正确
- 确保使用 HTTPS 地址（https://）
- WebSocket 会自动转换为 wss://
- 检查后端服务是否正常运行
Q: 文件上传失败怎么办？
A: - Railway 使用临时文件系统，重启后会丢失 - 配置 Railway Volume 持久化存储 - 或使用外部存储服务（S3、Cloudinary 等）
Q: 如何查看日志？
A: - 后端日志：查看终端输出或日志文件 - 前端日志：打开浏览器开发者工具（F12）
部署问题
Q: 如何部署到生产环境？
A: 请查看 部署指南
Q: Railway 部署需要注意什么？
A: - 配置环境变量 - 设置 MySQL 数据库 - 配置 Railway Volume 持久化存储 - 设置健康检查端点
Q: Vercel 部署需要注意什么？
A:
- 配置 Root Directory: client
- 配置环境变量
- 确保构建命令正确
其他问题
Q: 如何报告 Bug？
A: 请在 GitHub 仓库提交 Issue，包含： - 问题描述 - 复现步骤 - 预期行为 - 实际行为 - 环境信息
Q: 如何贡献代码？
A: 请查看 贡献指南
Q: 如何获取帮助？
A: - 查看 完整文档 - 查看 故障排除 - 提交 GitHub Issue
需要更多帮助？ 请查看 完整文档 或提交 Issue。