yushu/yushu-backend/TEST-NEW-SYSTEM.md

新消息系统测试指南

🚀 启动测试

1. 重启后端应用

# 重启Spring Boot应用以加载新的代码

2. 测试API接口

系统通知API测试

# 获取用户通知列表
GET http://localhost:8080/system/notification/my

# 获取未读通知数
GET http://localhost:8080/system/notification/unread/count

# 标记通知为已读
PUT http://localhost:8080/system/notification/1/read

用户对话API测试

# 获取会话列表
GET http://localhost:8080/chat/conversations

# 创建私聊会话
POST http://localhost:8080/chat/conversation/private/2

# 获取会话消息
GET http://localhost:8080/chat/conversation/conv_admin_testuser/messages

# 发送消息
POST http://localhost:8080/chat/conversation/conv_admin_testuser/message
Content-Type: application/json
{
  "content": "测试消息"
}

# 设置备注
PUT http://localhost:8080/chat/conversation/conv_admin_testuser/remark
Content-Type: application/json
{
  "remarkName": "测试备注"
}

3. 前端页面测试

访问消息页面

• URL: http://localhost:8081/message
• 功能: 用户对话界面
• 测试: 会话列表、发送消息、设置备注

访问系统通知页面

• URL: http://localhost:8081/system/message
• 功能: 系统通知管理
• 测试: 通知列表、创建通知、发布通知

🔍 预期结果

数据库数据

执行SQL后应该有：

• 2条系统通知记录
• 2个测试会话
• 3条对话消息

API响应

• 会话列表应该返回2个会话
• 每个会话包含正确的用户信息和最后消息
• 消息发送应该成功并更新会话

前端界面

• 会话列表正确显示
• 消息收发正常
• 备注功能工作正常

🐛 常见问题

编译错误

• 确保所有实体类已重新创建
• 检查import语句是否正确
• 验证Mapper接口和XML文件匹配

数据库错误

• 确认SQL脚本已正确执行
• 检查表结构是否正确创建
• 验证测试数据是否插入成功

API错误

• 检查Controller路径映射
• 验证Service层依赖注入
• 确认权限配置正确

✅ 成功标志

当以下所有项目都正常工作时，系统部署成功：

• 后端应用启动无错误
• 数据库表创建成功
• 测试数据插入成功
• 会话列表API返回正确数据
• 消息发送API工作正常
• 前端页面正确显示会话
• 备注功能正常工作
• WebSocket连接正常

📞 故障排除

如果遇到问题：

1. 检查后端日志
2. 验证数据库连接
3. 确认API路径正确
4. 检查前端控制台错误
5. 验证WebSocket连接状态