如何修复截断的 MP4 视频：Untrunc 完整使用指南

如何修复截断的 MP4 视频Untrunc 完整使用指南【免费下载链接】untruncRestore a truncated mp4/mov. Improved version of ponchio/untrunc项目地址: https://gitcode.com/gh_mirrors/un/untruncUntrunc 是一款免费的命令行 MP4 修复工具通过一个完好的相似参考视频重建文件索引恢复被截断或损坏的 mp4、m4v、mov、3gp 视频支持 Windows、macOS 与 Linux。修复后原本无法播放的文件会变成带_fixed后缀的可播放文件。本文覆盖能否修复的判断、环境准备、完整修复流程、失败排查、批量处理与参考文件管理。先判断你的文件能不能修Untrunc 的作用是重建索引它不对存储介质做底层数据恢复也无法还原被覆盖的数据。开始前对照下面两张清单可修复的情形录制因断电、存储卡满、传输中断或系统崩溃而中断文件大小基本正常但播放器提示无法打开或只能播放开头几秒文件开头或结尾缺失播放器提示“格式不支持”“文件已损坏”但文件仍有大量实际内容视频数据区还在只是记录位置的 moov 索引原子通常在文件尾部不完整或损坏编码为 H.264avc1或 H.265hvc1容器为 mp4 家族且你能拿到同设备的参考文件不可修复或成功率极低的情形文件数据区本身已大面积清零或被覆盖通常由存储介质物理损坏造成容器不是 mp4 家族如 avi、mkv、flv拿不到与损坏文件设备和录制设置匹配的参考文件如果落入右侧任意一条不建议继续请先备份原文件。左侧四条全部满足再往下看修复流程。一次性准备安装工具与选择参考文件安装 untruncLinuxDebian/Ubuntusudo apt-get install libavformat-dev libavcodec-dev libavutil-dev git clone https://gitcode.com/gh_mirrors/un/untrunc cd untrunc make sudo cp untrunc /usr/local/binmacOSHomebrewbrew install ffmpeg yasm cd untrunc CPPFLAGS-I/opt/homebrew/include LDFLAGS-L/opt/homebrew/lib \ PKG_CONFIG_PATH/opt/homebrew/lib/pkgconfig makeWindows从项目发布页下载预编译包解压即用无需编译README 中有入口说明。若不想改动系统环境也可以用 Docker 构建运行项目根目录提供了 Dockerfile。编译失败通常是 ffmpeg 版本不匹配可用make FF_VER3.3.9构建指定版本。安装完成后可用untrunc -V确认版本。核心解析逻辑位于src/目录其中avc1/与hvc1/子目录分别处理 H.264 与 H.265。选择参考文件与损坏文件来自同一设备手机、相机或监控摄像头这一条最关键相同的录制设置分辨率、帧率、码率、编码格式H.264 或 H.265一致参考文件本身能完整正常播放可先用ffprobe 参考.mp4核对分辨率、帧率与编码长度 10~30 秒即可参考文件只要求编码参数匹配内容无需相似原理说明MP4 文件中由 moov 原子记录编码参数与各数据块mdat的偏移位置录制中断时索引往往缺失播放器因此找不到数据。Untrunc 先解析参考文件得到轨道结构与编码匹配规则再逐块扫描损坏文件的数据区进行比对最后重写一份完整索引。完整修复流程输入同一目录下放置两个文件参考文件ok.mp4完好与broken.mp4损坏。修复前建议先把损坏文件复制到另一个位置这是习惯而非必需。命令untrunc ok.mp4 broken.mp4第一个参数始终是参考文件第二个是损坏文件顺序颠倒会报错。运行过程中程序会打印解析进度如需跳过交互提示可加-n使用非交互模式。程序还带重复检测判断输入已是修复产物时会直接结束。输出运行完成后同目录生成broken_fixed.mp4格式与原文件一致可被播放器直接打开原文件不会被修改。默认输出位置与损坏文件同目录可用-dst dir改到其他位置。验证用 VLC 或 ffplay 播放确认可从头播到尾尾部通常是问题最多的区域重点看最后几秒ffprobe broken_fixed.mp4检查视频、音频流是否齐全时长是否合理可选的完整解码校验ffmpeg -v error -i broken_fixed.mp4 -f null -报错越少越好若尾部仍有问题可用ffmpeg -i broken_fixed.mp4 -c copy output.mp4重新封装提升兼容性修复失败排查先用-v查看完整日志再对照下表症状可能原因处置动作启动即报错提示读不到文件参考文件本身损坏或扩展名与实际内容不符用 ffprobe 验证参考文件换一份确认可用的生成了输出文件但无法播放或只有单一流参考文件与损坏文件设备或设置不匹配换更接近的同设备同设置参考文件用-v复跑看日志运行极慢或停在某处文件中存在大量未知数据用-s跳过未知数据段并用-st指定步进修复后画面与声音不同步重建索引后视频与音频时长不一致加-sv把视频拉伸到与音频时长一致日志提示找不到 mdat文件结构破坏严重用-sm强制搜索数据区配合-v定位批量与自动化文件不多时无需脚本逐个执行基础命令即可。同一参考文件ref.mp4、损坏文件集中在 broken 目录时一行命令就能批量for f in broken/*.mp4; do untrunc ref.mp4 $f; done损坏文件来自多台设备时按设备分目录把损坏文件与对应参考文件放在同一目录逻辑相同。重复运行时加-skip会自动跳过已有输出文件便于随时重跑。日常防护参考文件库与备份按设备建立参考文件库目录以“设备参数”命名如 iPhone15_4K30、GoPro10_1080p60每目录放一份 10~30 秒的参考文件修改设备录制设置分辨率、帧率、编码后立即补录并归档新的参考文件文件名标注日期长时段拍摄时在开头补拍一段 5 秒短片与素材一起归档素材损坏时可当参考文件使用发现损坏文件先复制原文件再修复untrunc 不改动原文件其他恢复手段可能会改动每台监控摄像头保留一份参考文件断电或拔卡后第一时间拷贝文件再执行批量修复常见问题问untrunc 会修改原始的损坏文件吗 答不会。整个过程只读取原文件生成带_fixed后缀的新文件。问修复后的文件能直接进剪辑软件吗 答可以但建议先做一次完整解码确认尾部没有残留错误有问题时用-c copy重新封装或重新编码。问支持 4K 和超过 2GB 的大文件吗 答该版本支持超过 2GB 的文件并对 GoPro 与索尼 XAVC 的 4K 素材做了针对性兼容。问与原始 ponchio 版本相比有什么不同 答该版本速度大幅提升、内存占用更低可跳过未知字节、处理无效的原子长度并支持时间码轨道。问参考文件与损坏文件来自同品牌不同机型能用吗 答可以但成功率明显低于同设备。官方 README 建议优先使用同一相机拍摄的参考文件尽量找匹配的。命令速查命令用途untrunc ok.mp4 broken.mp4基本修复输出broken_fixed.mp4untrunc -v ok.mp4 broken.mp4输出详细日志用于排查untrunc -s -st 500 ok.mp4 broken.mp4跳过未知数据段untrunc -sv ok.mp4 broken.mp4将视频拉伸到与音频时长一致untrunc -sm ok.mp4 broken.mp4结构受损时强制搜索数据区untrunc -skip ok.mp4 broken.mp4跳过已有输出文件的文件ffprobe broken_fixed.mp4验证修复后的流与时长ffmpeg -v error -i broken_fixed.mp4 -f null -完整解码校验ffmpeg -i broken_fixed.mp4 -c copy out.mp4重新封装提升兼容性参考文件就位后修复本身只是一条命令加一次验证真正需要提前投入的是你为每台设备归档的参考文件库。【免费下载链接】untruncRestore a truncated mp4/mov. Improved version of ponchio/untrunc项目地址: https://gitcode.com/gh_mirrors/un/untrunc创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考