视频封面与帧提取失败、卡住或结果不对？排错指南
按编码、容器、参数、内存和浏览器顺序排查视频封面与帧提取，并理解转码质量与设备边界。
不要改后缀冒充格式
媒体扩展名只是容器名称，不代表内部视频、音频编码一定受支持。保留原文件，记录文件大小、时长、编码、分辨率、浏览器和完整错误；不要反复覆盖唯一原件。
本工具最容易忽略的问题
例如在 00:12.3 提取 JPG 封面。时间点位于两帧之间时解码器会选择附近帧；当前只输出 JPG，不提供 PNG。
推荐排查顺序
- 用很短、分辨率较低的已知正常样本确认工具能够加载。
- 检查页面是否读到时长、视频轨、音频轨和尺寸；读不到通常是损坏或编解码器不支持。
- 减少时长、分辨率、帧率或同时处理的文件数量。
- 关闭其他大型标签页，用最新版桌面 Chrome/Edge 重试并保持页面前台。
- 对照以下步骤重新设置：
- 选择视频并等待读取时长。
- 输入要提取的时间点。
- 开始提取固定质量的 JPG。
- 检查方向、颜色和清晰度后下载。
- 仍失败时使用桌面 FFmpeg 或创建该文件的专业软件，不要宣称网页支持该编码。
参数检查
- 时间点；当前只输出固定质量 JPG，没有 PNG 或质量滑块
常见错误
为什么不是完全同一帧？
时间点可能位于帧之间，解码器会选择附近可解码帧。
可以下载 PNG 吗？
当前页面只输出 JPG，不承诺 PNG。
视频会上传吗？
媒体文件只在当前浏览器标签页中读取和转码，不会为了运行该工具上传到 FreeTool 服务器。
无法绕过的边界
- 不批量提取全部帧
- 不支持的编码或损坏时间戳会失败
- HDR/广色域转普通图片可能改变颜色
浏览器 WASM 没有原生应用的全部性能和编解码器，长视频可能耗时很久。进度暂时不变化不等于服务器上传；处理发生在当前标签页，但浏览器仍可能因为内存压力终止任务。
隐私、版权与开源许可证
媒体文件只在当前浏览器标签页中读取和转码，不会为了运行该工具上传到 FreeTool 服务器。 排错截图和输出文件仍可能包含隐私、受版权保护内容或隐藏 metadata，分享前要检查。ffmpeg.wasm wrapper 为 MIT；本期 FFmpeg core 为 GPL-2.0-or-later，不能删除源代码获取方式与许可证 Notice。