排障
排障
与资源包 docs/DEVELOPER.md 故障排查节一致。接口错误码见 createVideoDownloadStreamUrl。
步骤
对照下表定位后,再用创流得到的 RTSP 做独立拉流验证。
| 现象 | 可能原因 | 建议 |
|---|---|---|
创流 code != "0" | token、设备、权限、参数 | 看 result.msg;对照接口错误码 |
| 解密失败 | token 与创流请求不一致 | 必须使用同一 params.token |
FFmpeg 数秒内 End of file / Invalid data | 录像无片源、RTSP 已失效 | 换 real 对比;确认 begin/end 有录像;创流后尽快拉流 |
Error parsing AU headers | RTSP AAC 封装与解析差异 | 多数可忽略,看是否仍能出 MP4 |
aac_adtstoasc 初始化失败或 exit -22 | 误用视频 BSF,或无 AAC 时仍强制音频 BSF | 当前 Demo 仅 -bsf:a aac_adtstoasc,勿链式 hevc/h264 |
| 最后一片无法播放 | 墙钟到点强杀进程 | 向 stdin 发 q 并等待收尾 |
| 拉流超过设定总时长 | 旧版用流时间戳当停表 | 使用当前资源包(墙钟 stop) |
| 桌面版未找到 FFmpeg | 安装包不完整或开发构建未校验 sidecar | 确认安装完整;源码构建先 npm run verify-sidecars |
| CLI 找不到 FFmpeg | 缺少 binaries/ 或 OS 不匹配 | 确认 ffmpeg-x86_64-pc-windows-msvc.exe 或 Linux 对应文件;Linux chmod +x |
| 输出路径异常 / 中文目录失败 | 混用 \ 与 /,或非 UTF-8 配置 | 用系统路径拼接;配置文件 UTF-8 |
| 录制弹出黑色控制台 | 旧版未隐藏 FFmpeg 窗口 | 换当前资源包 |
独立验证 RTSP(创流并解密后立即):
ffplay -rtsp_transport tcp "rtsp://..."
# 或
ffmpeg -rtsp_transport tcp -i "rtsp://..." -t 5 -f null -
若同样 EOF,问题在流侧而非本工具。