新增功能

2026-03-04 15:32:30 +08:00
parent a07e844c47
commit ab77f5488d
2266 changed files with 177942 additions and 3444 deletions
@@ -0,0 +1,351 @@
+# userId 格式检查指南
+
+## 🎯 核心问题
+
+**userId 格式必须完全一致！**
+
+如果格式不一致，会导致：
+- ❌ 提示"对方不在线"（错误代码 60011）
+- ❌ 无法接听来电
+- ❌ 无法发起通话
+
+## 📋 正确的格式
+
+### 医生端（Web）
+```
+登录 userId: doctor_1
+呼叫目标: patient_2
+```
+
+### 患者端（小程序）
+```
+登录 userId: patient_2
+呼叫目标: doctor_1
+```
+
+## 🔍 检查步骤
+
+### 步骤 1：检查后端接口
+
+#### 医生端获取签名接口
+**接口：** `POST /api/tcm/getCallSignature`
+
+**请求：**
+```json
+{
+  "diagnosis_id": 1,
+  "patient_id": 2,
+  "admin_id": 1
+}
+```
+
+**期望响应：**
+```json
+{
+  "code": 1,
+  "data": {
+    "userId": "doctor_1",           // 医生自己的 userId（字符串）
+    "patientUserId": "patient_2",   // 要呼叫的患者 userId（字符串）
+    "sdkAppId": "1400xxxxxx",       // 字符串或数字都可以
+    "userSig": "eJw1..."
+  }
+}
+```
+
+**关键检查点：**
+- [ ] `userId` 是字符串 `"doctor_1"`，不是数字 `1`
+- [ ] `patientUserId` 是字符串 `"patient_2"`，不是数字 `2`
+- [ ] 格式统一：都是 `prefix_number` 格式
+
+#### 患者端获取签名接口
+**接口：** `GET /api/tcm/getPatientSignature?patient_id=2`
+
+**期望响应：**
+```json
+{
+  "code": 1,
+  "data": {
+    "userId": "patient_2",          // 患者自己的 userId（字符串）
+    "sdkAppId": "1400xxxxxx",
+    "userSig": "eJw1..."
+  }
+}
+```
+
+**关键检查点：**
+- [ ] `userId` 是字符串 `"patient_2"`，不是数字 `2`
+- [ ] 格式与医生端一致：`prefix_number`
+
+### 步骤 2：检查 Web 端日志
+
+**登录时：**
+```javascript
+console.log('=== 发起一对一通话 ===')
+console.log('后端返回的 patientUserId:', res.patientUserId)  // 应该是 "patient_2"
+console.log('最终使用的 targetUserId:', targetUserId)        // 应该是 "patient_2"
+```
+
+**关键检查点：**
+- [ ] `patientUserId` 是字符串 `"patient_2"`
+- [ ] `targetUserId` 是字符串 `"patient_2"`
+- [ ] 没有多余的空格或特殊字符
+
+### 步骤 3：检查小程序端日志
+
+**登录时：**
+```javascript
+console.log('=== 小程序端登录信息 ===')
+console.log('userId:', userId)  // 应该是 "patient_2"
+```
+
+**关键检查点：**
+- [ ] `userId` 是字符串 `"patient_2"`
+- [ ] 格式与 Web 端一致
+
+### 步骤 4：对比验证
+
+| 端 | 登录 userId | 呼叫目标 | 格式 |
+|----|------------|---------|------|
+| Web（医生） | `doctor_1` | `patient_2` | ✅ 一致 |
+| 小程序（患者） | `patient_2` | `doctor_1` | ✅ 一致 |
+
+**必须满足：**
+- Web 端呼叫的 `patient_2` === 小程序端登录的 `patient_2`
+- 小程序端呼叫的 `doctor_1` === Web 端登录的 `doctor_1`
+
+## ⚠️ 常见错误
+
+### 错误 1：数字 vs 字符串
+
+**错误示例：**
+```javascript
+// ❌ 错误：后端返回数字
+{
+  "userId": 1,              // 数字
+  "patientUserId": 2        // 数字
+}
+
+// ✅ 正确：应该返回字符串
+{
+  "userId": "doctor_1",     // 字符串
+  "patientUserId": "patient_2"  // 字符串
+}
+```
+
+**后果：**
+- Web 端使用 `2` 呼叫
+- 小程序端登录为 `"patient_2"`
+- 格式不匹配，无法通话
+
+### 错误 2：前缀不一致
+
+**错误示例：**
+```javascript
+// ❌ 错误：前缀不一致
+Web 端: "doctor_1"
+小程序端: "patient2"  // 缺少下划线
+
+// ✅ 正确：前缀一致
+Web 端: "doctor_1"
+小程序端: "patient_2"  // 都使用下划线
+```
+
+### 错误 3：大小写不一致
+
+**错误示例：**
+```javascript
+// ❌ 错误：大小写不一致
+Web 端: "Doctor_1"
+小程序端: "doctor_1"
+
+// ✅ 正确：大小写一致
+Web 端: "doctor_1"
+小程序端: "doctor_1"
+```
+
+## 🛠️ 后端代码检查
+
+### PHP 后端示例
+
+**医生端获取签名：**
+```php
+public static function getCallSignature(array $params)
+{
+    $adminId = $params['admin_id'] ?? 0;
+    $patientId = $params['patient_id'] ?? 0;
+    
+    // ✅ 正确：使用字符串格式
+    $doctorUserId = 'doctor_' . $adminId;      // "doctor_1"
+    $patientUserId = 'patient_' . $patientId;  // "patient_2"
+    
+    // ❌ 错误：不要这样做
+    // $doctorUserId = $adminId;                // 1
+    // $patientUserId = $patientId;             // 2
+    
+    return [
+        'sdkAppId' => (int)$config['sdkAppId'],
+        'userId' => $doctorUserId,              // "doctor_1"
+        'userSig' => $userSig,
+        'patientUserId' => $patientUserId,      // "patient_2"
+    ];
+}
+```
+
+**患者端获取签名：**
+```php
+public static function getPatientSignature(int $patientId)
+{
+    // ✅ 正确：使用字符串格式
+    $patientUserId = 'patient_' . $patientId;  // "patient_2"
+    
+    // ❌ 错误：不要这样做
+    // $patientUserId = $patientId;             // 2
+    
+    return [
+        'sdkAppId' => (int)$config['sdkAppId'],
+        'userId' => $patientUserId,             // "patient_2"
+        'userSig' => $userSig,
+    ];
+}
+```
+
+## 🧪 测试验证
+
+### 测试 1：打印 userId
+
+**Web 端（浏览器控制台）：**
+```javascript
+// 在发起通话前
+console.log('=== userId 格式检查 ===');
+console.log('类型:', typeof res.patientUserId);  // 应该是 "string"
+console.log('值:', res.patientUserId);           // 应该是 "patient_2"
+console.log('长度:', res.patientUserId.length);  // 应该是 9
+```
+
+**小程序端（微信开发者工具控制台）：**
+```javascript
+// 在登录后
+console.log('=== userId 格式检查 ===');
+console.log('类型:', typeof userId);  // 应该是 "string"
+console.log('值:', userId);           // 应该是 "patient_2"
+console.log('长度:', userId.length);  // 应该是 9
+```
+
+### 测试 2：对比 userId
+
+**在 Web 端发起呼叫时：**
+```javascript
+console.log('=== 对比检查 ===');
+console.log('Web 端呼叫目标:', targetUserId);        // "patient_2"
+console.log('小程序端应该登录为:', targetUserId);    // "patient_2"
+console.log('是否完全相等:', targetUserId === "patient_2");  // true
+```
+
+### 测试 3：手动验证
+
+1. **Web 端控制台执行：**
+   ```javascript
+   console.log(JSON.stringify({
+     type: typeof res.patientUserId,
+     value: res.patientUserId,
+     length: res.patientUserId.length
+   }));
+   ```
+
+2. **小程序端控制台执行：**
+   ```javascript
+   console.log(JSON.stringify({
+     type: typeof userId,
+     value: userId,
+     length: userId.length
+   }));
+   ```
+
+3. **对比结果：**
+   - 类型必须都是 `"string"`
+   - 值必须完全相同
+   - 长度必须相同
+
+## 📊 诊断表
+
+| 检查项 | Web 端 | 小程序端 | 状态 |
+|--------|--------|----------|------|
+| userId 类型 | string | string | ✅ |
+| userId 值 | doctor_1 | patient_2 | ✅ |
+| 呼叫目标类型 | string | string | ✅ |
+| 呼叫目标值 | patient_2 | doctor_1 | ✅ |
+| 格式一致性 | prefix_number | prefix_number | ✅ |
+
+## 🔧 修复建议
+
+### 如果后端返回的是数字
+
+**修改后端代码：**
+```php
+// 在返回前确保转换为字符串
+return [
+    'userId' => (string)$doctorUserId,      // 强制转换为字符串
+    'patientUserId' => (string)$patientUserId,
+    // ...
+];
+```
+
+### 如果前端收到的是数字
+
+**修改前端代码：**
+```javascript
+// Web 端
+const targetUserId = String(res.patientUserId);  // 确保是字符串
+
+// 小程序端
+const userId = String(signatureData.userId);     // 确保是字符串
+```
+
+## ✅ 验证清单
+
+在测试前，请确认：
+
+- [ ] 后端返回的 userId 是字符串格式
+- [ ] 后端返回的 patientUserId 是字符串格式
+- [ ] Web 端日志显示正确的 userId 格式
+- [ ] 小程序端日志显示正确的 userId 格式
+- [ ] Web 端呼叫目标与小程序端登录 userId 完全一致
+- [ ] 小程序端呼叫目标与 Web 端登录 userId 完全一致
+- [ ] 没有多余的空格或特殊字符
+- [ ] 大小写完全一致
+
+## 📞 如果仍然有问题
+
+请提供以下信息：
+
+1. **后端接口响应**（隐藏 userSig）：
+   ```json
+   {
+     "userId": "???",
+     "patientUserId": "???",
+     "sdkAppId": "???"
+   }
+   ```
+
+2. **Web 端日志**：
+   ```
+   类型: ???
+   值: ???
+   长度: ???
+   ```
+
+3. **小程序端日志**：
+   ```
+   类型: ???
+   值: ???
+   长度: ???
+   ```
+
+4. **具体错误信息**：
+   - 错误代码
+   - 错误提示
+
+---
+
+**最后更新：** 2024-03-04
+**版本：** 1.0