Agora云录制启动正常但query/stop返回404无录像及Azure密钥配置问题

Azure存储密钥配置正确性说明 #

你当前的配置操作不正确。Azure Blob存储对接Agora云录制时，两个鉴权字段对应不同的取值：

• key字段：需要填入Azure存储的存储账户名称，而非存储密钥
• secret key字段：可以直接使用存储密钥页的第一个密钥内容，不需要额外申请其他密钥

你将两个字段都填入存储密钥的操作，会导致Agora云录制服务无法正常连接你的Azure存储写入文件，录制任务会因存储鉴权失败提前自动销毁，是触发后续404问题的核心原因之一。

start接口正常但query/stop返回404、无录制文件的原因及修复方案 #

原因1：存储配置错误导致任务提前终止 #

修复方案：

• 修正存储鉴权字段配置，key替换为你的Azure存储账户名称，secret key保留原存储密钥值
• 同步核对其他存储配置项：bucket字段填入你创建的Blob容器名称，region字段填入和存储区域匹配的Agora官方区域编码，二者不能出现错填

原因2：接口参数不匹配导致任务未正常生成 #

虽然start接口返回200/201，但参数逻辑错误会导致服务侧未生成有效持久化的录制任务：
修复方案：

• 核对cname、uid参数：acquire、start、query、stop四个接口传入的频道名cname、录制用户IDuid必须完全一致，大小写、特殊符号不能有差异
• 核对resourceId、sid参数：query、stop接口传入的资源IDresourceId必须和acquire接口返回的一致，录制任务IDsid必须和start接口返回的一致，不能有字符遗漏或错写
• 检查resourceId有效期：acquire返回的resourceId有效期仅为5分钟，超时未调用start接口需要重新申请新的resourceId
• 核对录制模式配置：start接口的recordingConfig字段必须和你使用的录制模式（合流/单流/网页录制）匹配，不能出现配置项缺失或取值不符合要求的情况

原因3：频道无流导致任务自动销毁 #

Agora云录制任务启动后，默认连续30秒检测不到频道内有可录制的音视频流，会自动终止任务并释放资源，此时调用query/stop就会返回404：
修复方案：

• 启动录制前确认待录制频道内已有用户正常推流
• 可以在start接口的recordingConfig中调整maxIdleTime参数，延长无流等待时长，最大可设置为3600秒

原因4：接口调用路径错误 #

不同录制模式对应的接口路径前缀不同，路径错误会直接返回404：
修复方案：

• 云端合流/单流录制：接口路径前缀为/v1/apps/{appid}/cloud_recording
• 网页录制：接口路径前缀为/v1/apps/{appid}/web_recording
• 按需调整对应接口的路径前缀即可

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