BigBlueButton Join API生成链接失效：提示会议ID不存在

问题详情 #

调用自定义封装的Join接口（POST localhost:3000/bx_block_classes/meetings/join）生成的BigBlueButton会议链接无法访问，点击后提示会议ID不存在。

请求参数 #

{
 "meeting_id": "class-4-gg-135", // 由Create API生成
 "first_name": "Student", 
 "last_name": "demo",
 "password":"yENfzgxG"
}

接口响应 #

{
    "join_link": "https://test-install.blindsidenetworks.com/bigbluebutton/api/join?fullName=Studentdemo&meetingID=class-4-gg-135&password=yENfzgxG&checksum=3c2cdf84a2fd2ed521c6a8a6848c22a0f77f3579",
    "is_meeting_running": false
}

排查&解决步骤 #

1. 确认会议状态
   响应中is_meeting_running为false，说明目标会议要么未创建，要么创建后从未启动。BigBlueButton仅允许用户加入已启动的会议，未启动的会议会直接提示「会议ID不存在」。

   • 调用BigBlueButton官方getMeetingInfo接口，传入相同meetingID及校验值，确认会议是否存在。
   • 若会议已创建，先通过start接口启动会议再生成Join链接；若未创建，先调用Create API完成会议创建。

2. 核对会议ID一致性

   • 确认Create API返回的meetingID与Join请求传入的meeting_id完全匹配（注意大小写、特殊字符、空格，BigBlueButton会议ID大小写敏感）。

3. 校验Join链接合法性

   • 检查checksum生成逻辑：BigBlueButton要求将join+fullName+meetingID+password+服务器salt拼接后做SHA-1哈希，确认自定义接口是否使用了正确的服务器salt，且参数拼接顺序、格式无误。
   • 注意链接中fullName为Studentdemo（无空格），部分场景下需将空格编码为%20后传入，避免格式异常。

4. 验证密码权限
   确认传入的password是会议的参会者密码，而非主持人密码。误用主持人密码可能导致权限验证失败，部分场景会返回「会议ID不存在」的错误提示。

内容的提问来源于stack exchange，提问作者Sid