zyt/admin/QUICK_TEST_AFTER_UPGRADE.md

升级后快速测试指南

🚀 快速开始

步骤 1：重新安装依赖

cd admin

# 删除旧依赖
rm -rf node_modules package-lock.json

# 安装新依赖
npm install

预期结果：

✅ 安装成功
✅ 没有错误
✅ package-lock.json 已生成

步骤 2：启动开发服务器

npm run dev

预期结果：

✅ 编译成功
✅ 没有错误
✅ 服务器启动在 http://localhost:xxxx

步骤 3：登录系统

1. 打开浏览器
2. 访问 http://localhost:xxxx
3. 登录医生账号

预期结果：

✅ 登录成功
✅ 进入系统首页
✅ 没有控制台错误

步骤 4：测试视频通话

1. 进入患者管理页面
2. 找到一个患者
3. 点击"视频通话"按钮

预期结果：

✅ 弹出通话窗口
✅ 显示"准备通话..."
✅ 点击"开始通话"后初始化成功
✅ 显示"等待对方接听..."

步骤 5：小程序端接听

1. 小程序端登录对应的患者
2. 等待来电
3. 点击"接听"

预期结果：

✅ 小程序收到来电
✅ 显示来电界面
✅ 点击接听后通话接通
✅ 双方视频和音频正常

📋 检查清单

编译检查

• npm install 成功
• npm run dev 成功
• 没有编译错误
• 没有类型错误

功能检查

• 登录成功
• 视频通话窗口正常打开
• 初始化成功
• 可以发起通话
• 小程序端可以接收来电
• 通话可以接通
• 视频显示正常
• 音频传输正常
• 可以正常挂断

控制台检查

• 没有红色错误
• 没有导入错误
• 状态回调正常
• userId 格式正确

⚠️ 常见问题

问题 1：安装失败

症状：

npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree

解决：

npm install --legacy-peer-deps

问题 2：编译错误

症状：

Cannot find module '@trtc/calls-uikit-vue'

解决：

# 1. 确认 package.json 中的包名正确
"@trtc/calls-uikit-vue": "^4.2.2"

# 2. 删除依赖重新安装
rm -rf node_modules package-lock.json
npm install

问题 3：运行时错误

症状：

TUICallKitServer is undefined

解决：

1. 检查导入语句：

   import { TUICallKitServer } from '@trtc/calls-uikit-vue'
   

2. 重启开发服务器
3. 清除浏览器缓存

问题 4：通话失败

症状：

Error: 对方不在线 (60011)

解决：

1. 检查小程序端是否已登录
2. 检查 userId 格式是否一致
3. 查看详细日志

🔍 详细日志检查

Web 端日志

登录后：

WebRTC 环境检测: { isHttps: true, ... }
签名获取成功: { doctorUserId: "doctor_1", patientUserId: "patient_2", ... }
TUICallKit init 方法调用完成
初始化完成，显示通话界面

发起通话后：

=== 发起一对一通话 ===
后端返回的 patientUserId: patient_2
最终使用的 targetUserId: patient_2
通话已发起，目标用户: patient_2
>>> 正在呼叫

接通后：

>>> 通话已接通

小程序端日志

登录后：

=== 页面已挂载 ===
=== 已设置详细日志级别 ===
获取签名成功: { userId: "patient_2", ... }
TUICallKit 初始化成功, userId: patient_2
=== TUICallKit 初始化完成，等待来电 ===

收到来电后：

[tuikit engine wasm] onNewMessageReceived
=== 通话状态变化 === calling
=== 通话角色 === callee
=== 通话类型 === 2

🎯 成功标准

当你看到以下情况时，说明升级成功：

Web 端

• ✅ 编译成功，没有错误
• ✅ 可以正常登录
• ✅ 可以打开通话窗口
• ✅ 可以初始化 TUICallKit
• ✅ 可以发起通话
• ✅ 状态回调正常

小程序端

• ✅ 可以正常登录
• ✅ 可以接收来电
• ✅ 状态监听正常
• ✅ 可以正常接听

互通测试

• ✅ Web → 小程序通话正常
• ✅ 小程序 → Web 通话正常
• ✅ 视频和音频都正常
• ✅ 通话稳定，不掉线

📞 需要帮助？

如果测试失败，请提供：

1. 安装日志

   npm install > install.log 2>&1
   

2. 编译日志

   • 完整的编译错误信息
   • 截图

3. 运行时日志

   • 浏览器控制台日志
   • 小程序控制台日志

4. 错误信息

   • 错误代码
   • 错误提示
   • 完整的错误堆栈

📚 相关文档

• UIKIT_UPGRADE_COMPLETE.md - 完整升级说明
• WEB_UIKIT_UPGRADE_GUIDE.md - Web 端升级指南
• USERID_FORMAT_CHECK.md - userId 格式检查
• FINAL_TEST_CHECKLIST.md - 完整测试清单

---

最后更新： 2024-03-04 版本： 1.0