Agora云录制Postman调用:acquire/start正常但query、stop返回404
Agora 云录制调试query、stop接口返回404的排查方向
结合当前acquire、start接口返回200,但query、stop全量返回404的现象,按以下优先级逐点排查即可定位问题:
- 先核对query、stop接口的路径参数是否完全匹配
Agora云录制的query、stop接口需要三个强一致参数才能定位到对应录制实例:acquire接口返回的resourceId、全流程使用的频道名cname、录制用户IDuid,任意一个参数不匹配都会直接返回404。
常见的参数错位问题包括:- 没有把acquire响应里的
resourceId字段正确同步到Postman环境变量,导致请求路径里的{{ResourceId}}还是占位符空值,网关根本匹配不到对应的资源 - 调试过程中临时修改了环境变量,导致query/stop请求里的
cname、uid和acquire、start阶段用的值对不上 - 错把acquire响应里的请求ID、start响应里的录制会话ID
sid当成resourceId传入请求路径
- 没有把acquire响应里的
- 再确认录制实例是否真正完成初始化
接口返回200只代表请求被Agora网关接收,不代表录制实例已经正常拉起。如果存在配置错误导致后台初始化失败,实例会被直接销毁,后续调用query、stop时就会因为找不到存活实例返回404。
重点排查两个细节:- 不要只看start接口返回的
code为200,要拉完整响应体核对是否正常返回了录制会话IDsid,如果响应只有"request accepted"的提示、没有sid字段,说明实例根本没真正启动 - 逐字核对配置项:一是storageConfig的实际配置值,特别是AWS S3的bucket所属区域和配置里的
region值是否完全一致——哪怕你能用对应AK/SK往bucket传其他文件,只要bucket实际区域和给Agora填的区域不匹配,录制实例就会初始化鉴权失败;二是请求体的字段格式,你当前start请求体里的maxResolutionUid字段填的是带引号的字符串值"1",但Agora要求该字段为数字类型,这类格式错误也可能导致后台初始化录制实例失败,让实例直接被销毁
- 不要只看start接口返回的
- 最后排查基础连接类问题
- 核对四个接口的域名、API版本路径是否完全统一,比如acquire、start用的是v1版本的接口端点,query、stop不小心被切到了其他版本的路径,就会出现部分接口可通、部分接口因端点不存在返回404
- 检查
resourceId的调用时效,acquire生成的resourceId有效期为5分钟,如果生成后间隔太久才调用start,后续触发query/stop请求时resourceId已经过期失效,系统也会返回404
内容的提问来源于stack exchange,提问作者Chihiro
相关产品推荐
相关产品推荐

