zyt/wx/TUICallKit/USERID_FORMAT_CHECK.md

userId 格式检查指南

🎯 核心问题

userId 格式必须完全一致！

如果格式不一致，会导致：

• ❌ 提示"对方不在线"（错误代码 60011）
• ❌ 无法接听来电
• ❌ 无法发起通话

📋 正确的格式

医生端（Web）

登录 userId: doctor_1
呼叫目标: patient_2

患者端（小程序）

登录 userId: patient_2
呼叫目标: doctor_1

🔍 检查步骤

步骤 1：检查后端接口

医生端获取签名接口

接口： POST /api/tcm/getCallSignature

请求：

{
  "diagnosis_id": 1,
  "patient_id": 2,
  "admin_id": 1
}

期望响应：

{
  "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

期望响应：

{
  "code": 1,
  "data": {
    "userId": "patient_2",          // 患者自己的 userId（字符串）
    "sdkAppId": "1400xxxxxx",
    "userSig": "eJw1..."
  }
}

关键检查点：

• userId 是字符串 "patient_2"，不是数字 2
• 格式与医生端一致：prefix_number

步骤 2：检查 Web 端日志

登录时：

console.log('=== 发起一对一通话 ===')
console.log('后端返回的 patientUserId:', res.patientUserId)  // 应该是 "patient_2"
console.log('最终使用的 targetUserId:', targetUserId)        // 应该是 "patient_2"

关键检查点：

• patientUserId 是字符串 "patient_2"
• targetUserId 是字符串 "patient_2"
• 没有多余的空格或特殊字符

步骤 3：检查小程序端日志

登录时：

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 字符串

错误示例：

// ❌ 错误：后端返回数字
{
  "userId": 1,              // 数字
  "patientUserId": 2        // 数字
}

// ✅ 正确：应该返回字符串
{
  "userId": "doctor_1",     // 字符串
  "patientUserId": "patient_2"  // 字符串
}

后果：

• Web 端使用 2 呼叫
• 小程序端登录为 "patient_2"
• 格式不匹配，无法通话

错误 2：前缀不一致

错误示例：

// ❌ 错误：前缀不一致
Web 端: "doctor_1"
小程序端: "patient2"  // 缺少下划线

// ✅ 正确：前缀一致
Web 端: "doctor_1"
小程序端: "patient_2"  // 都使用下划线

错误 3：大小写不一致

错误示例：

// ❌ 错误：大小写不一致
Web 端: "Doctor_1"
小程序端: "doctor_1"

// ✅ 正确：大小写一致
Web 端: "doctor_1"
小程序端: "doctor_1"

🛠️ 后端代码检查

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"
    ];
}

患者端获取签名：

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 端（浏览器控制台）：

// 在发起通话前
console.log('=== userId 格式检查 ===');
console.log('类型:', typeof res.patientUserId);  // 应该是 "string"
console.log('值:', res.patientUserId);           // 应该是 "patient_2"
console.log('长度:', res.patientUserId.length);  // 应该是 9

小程序端（微信开发者工具控制台）：

// 在登录后
console.log('=== userId 格式检查 ===');
console.log('类型:', typeof userId);  // 应该是 "string"
console.log('值:', userId);           // 应该是 "patient_2"
console.log('长度:', userId.length);  // 应该是 9

测试 2：对比 userId

在 Web 端发起呼叫时：

console.log('=== 对比检查 ===');
console.log('Web 端呼叫目标:', targetUserId);        // "patient_2"
console.log('小程序端应该登录为:', targetUserId);    // "patient_2"
console.log('是否完全相等:', targetUserId === "patient_2");  // true

测试 3：手动验证

1. Web 端控制台执行：

   console.log(JSON.stringify({
     type: typeof res.patientUserId,
     value: res.patientUserId,
     length: res.patientUserId.length
   }));
   

2. 小程序端控制台执行：

   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	✅

🔧 修复建议

如果后端返回的是数字

修改后端代码：

// 在返回前确保转换为字符串
return [
    'userId' => (string)$doctorUserId,      // 强制转换为字符串
    'patientUserId' => (string)$patientUserId,
    // ...
];

如果前端收到的是数字

修改前端代码：

// Web 端
const targetUserId = String(res.patientUserId);  // 确保是字符串

// 小程序端
const userId = String(signatureData.userId);     // 确保是字符串

✅ 验证清单

在测试前，请确认：

• 后端返回的 userId 是字符串格式
• 后端返回的 patientUserId 是字符串格式
• Web 端日志显示正确的 userId 格式
• 小程序端日志显示正确的 userId 格式
• Web 端呼叫目标与小程序端登录 userId 完全一致
• 小程序端呼叫目标与 Web 端登录 userId 完全一致
• 没有多余的空格或特殊字符
• 大小写完全一致

📞 如果仍然有问题

请提供以下信息：

1. 后端接口响应（隐藏 userSig）：

   {
     "userId": "???",
     "patientUserId": "???",
     "sdkAppId": "???"
   }
   

2. Web 端日志：

   类型: ???
   值: ???
   长度: ???
   

3. 小程序端日志：

   类型: ???
   值: ???
   长度: ???
   

4. 具体错误信息：

   • 错误代码
   • 错误提示

---

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