工作流 约 5 分钟
视频转换失败排查：从源文件到参数
视频转换失败很少是玄学，绝大多数能归到三类：源文件本身、参数组合、运行环境。按命中率从高到低排查，多数问题几分钟出结果。
第一类：源文件的问题（命中率最高）
先确认源文件"本身是好的"：用本地播放器打开，能正常播放才有转换的基础。播放器都打不开的文件（下载不完整、传输截断），任何转换工具都无能为力——先重取一份完整的。
源能播但转换失败，多半是罕见编码：采集卡私有编码、冷门监控格式、损坏索引的流。用编码检测工具看一眼视频流和音轨的编码名称——常见编码（H.264/H.265/VP9/AAC/MP3）出问题的概率极低，罕见编码则需要先转一道通用格式（如先用桌面工具救成 MP4）再进后续流程。
第二类：参数组合的问题
参数失败的典型：裁切区域全为零（等于没裁，部分工具会拒绝）；时间范围起点晚于终点；目标体积设得比"最低可能"还小（压缩器做不到就报错）；超大分辨率素材配上极端参数导致内存超限。报错信息里通常有参数回显，对着查。
长视频转换卡住不动，常见原因是浏览器内存压力：几十分钟的 4K 素材在本地方案里是内存大户。对策是分段处理——先用剪切工具切成 10 分钟一段，逐段转换后拼接，内存压力降一个数量级。
第三类：环境与状态的问题
本地处理依赖浏览器环境：标签页被冻结（切走太久）、系统休眠、内存被其他标签吃光，都会让处理中断。转换大文件时保持标签在前台、关闭其他重页签、插着电源防休眠。
输出文件打不开是另一类问题：先确认输出容器的播放器支持性（TS、FLV 这类容器部分播放器不认），再用编码检测工具看产物是否完整。产物能检测出正常参数就是播放器问题，换通用播放器或转 MP4 兜底。