安防视频汇聚系统EasyCVR下载十几秒的录像报错404？原因竟是一个不起眼的“/”

EasyCVR视频汇聚系统作为一款专注于安防视频融合管理的核心平台，凭借多协议设备接入（如GB28181、RTSP/RTMP等）、全天候录像存储、远程视频回放与录像下载等功能，已广泛应用于园区监控、企业安防、交通运维等场景，为用户提供 “采集 - 存储 - 管理 - 应用” 的全链路视频服务。其中，录像下载功能是用户事后追溯事件、留存关键视频数据的重要支撑。

一、问题背景

近期接到用户反馈，EasyCVR平台在获取设备录像时，预下载时长小于10分钟的录像文件出现异常，而10分钟以上的录像下载功能正常，需技术团队介入排查。

二、故障现象分析

1）现象复现：

技术人员对比测试发现，点击下载10分钟以下的设备录像时，系统返回接口404错误（资源未找到），而10分钟以上的录像下载接口调用正常。

2）接口调用排查：

进一步分析接口发现，在调用录像下载接口downloaddevicerecord/[通道ID]/[文件名] 时，若设备录像文件名中包含“/”符号，会导致系统在拼接URL时错误地添加额外路径分隔符，进而引发404报错。

三、技术根因定位

问题本质：

录像文件命名中包含 “/” 符号时，HTTP接口会将其识别为路径分隔符，导致接口参数被错误解析。例如，文件名中的 “/” 会被误认为是接口路径的层级划分，从而使实际请求路径与服务器资源路径不匹配。

影响范围：

仅影响文件名包含 “/” 符号且时长小于10分钟的录像文件（推测10分钟以上录像的文件名生成规则可能规避了该符号）。

四、解决方案与优化建议

修改文件名规则后，小于10分钟的设备录像下载功能恢复正常，文件可完整下载。

未来，EasyCVR平台还将结合用户在多场景下的录像应用需求持续迭代，确保在视频采集、存储、管理全流程中，为用户提供更可靠、更贴合业务实际的技术支持，助力安防视频管理工作高效落地。