企业官网建设流程全解析

MP4文件损坏怎么办：untrunc无损修复完整指南

【免费下载链接】untruncRestore a truncated mp4/mov. Improved version of ponchio/untrunc项目地址: https://gitcode.com/gh_mirrors/un/untrunc

相机录到一半突然断电，文件还在，播放器却打不开了。untrunc 是一个免费的命令行修复工具，用同设备的健康视频为截断的 MP4、MOV 重建索引，适合需要抢救录像的普通用户和开发者。它不重新编码，只重写文件的索引信息。

为什么值得先试 untrunc

无损结构重建

MP4 文件由一个个"原子"（atom）拼成。断电或传输中断时，坏的往往只是索引，画面数据还在原处。untrunc 只重建索引，不碰媒体数据，修复后画质与原片一致。

处理快、占内存低

这个版本比原版快 10 倍以上，内存占用也做了优化。支持 2GB 以上的大文件，能处理无效的原子长度，还专门适配了 GoPro 和 Sony XAVC 机型。

修复流程只有四步

1. 读入健康视频，提取轨道与原子模板
2. 在损坏文件里定位 mdat 等数据块
3. 用模板重写索引与时长信息
4. 输出<文件名>_fixed.mp4，原文件保持不动

容器解析逻辑集中在 src/mp4.cpp 和 src/atom.cpp，轨道与采样表在 src/track.cpp，H.264 与 HEVC 的码流解析分别在 src/avc1/ 和 src/hvc1/。

环境搭建：三种方式拿到 untrunc

Linux / Ubuntu 下编译

sudo apt-get install libavformat-dev libavcodec-dev libavutil-dev # FFmpeg 依赖库 git clone https://gitcode.com/gh_mirrors/un/untrunc cd untrunc make # 用系统 FFmpeg 编译 sudo cp untrunc /usr/local/bin

系统 FFmpeg 版本不合适时，可改用自带版本：make FF_VER=3.3.9，编译脚本会自动下载对应源码。

macOS 下编译

brew install ffmpeg yasm export PKG_CONFIG_PATH="/opt/homebrew/lib/pkgconfig" CPPFLAGS="-I/opt/homebrew/include" LDFLAGS="-L/opt/homebrew/lib" make

Docker 容器运行

docker build -t untrunc . # 仓库自带 Dockerfile docker run --rm -v ~/Videos/:/mnt untrunc /mnt/ok.mp4 /mnt/broken.mp4

容器方式免编译，镜像里已带运行库，构建细节见 Dockerfile。Windows 用户则可以直接下载预编译版本，无需配置。

核心工作流：从参考视频到修复文件

拿到可用结果的最小命令

untrunc /path/to/working.mp4 /path/to/broken.mp4

第一个参数是健康参考视频，第二个是损坏文件。参考视频尽量来自同一台设备，分辨率、帧率、编码一致，成功率会高很多。运行成功后，同目录生成broken_fixed.mp4，可直接播放。

验证修复效果

untrunc -v working.mp4 broken.mp4 # -v 输出详细匹配日志 untrunc -i working.mp4 # 查看参考视频的轨道信息

-v日志能看到模板匹配和索引重写的过程，出问题时这是排查的第一手信息。

只分析、不落盘

untrunc -dw working.mp4 broken.mp4 # 仅分析，不写 _fixed 文件

不确定能否修好时，先跑这一条，看看日志里 mdat 和轨道的匹配情况再决定。

实战片段：三类常见损坏

断电截断的相机录像

现象：文件尾部缺失，播放器提示损坏。 操作：用同相机、同参数的视频做参考，直接运行修复命令。 结果：输出可播放的 _fixed 文件，只有断电后的片段缺失。

传输中断的录像

现象：拷贝或上传中断，文件只剩原大小的一部分，结构不完整。 操作：

untrunc -sm working.mp4 broken.mp4 # 无结构时也搜索 mdat

结果：数据块被定位，索引按模板重建，主体画面恢复。

批量处理多个文件

现象：一次事故坏了一批文件。 操作：

for f in broken_*.mp4; do untrunc -skip ref.mp4 "$f"; done

-skip会自动跳过已修复的文件，脚本可以反复执行而不重复劳动。

排障速查

修复后无法播放

可能原因：参考视频与损坏文件的编码参数不一致，设备、分辨率或编码格式都对不上。 解法：换用同设备、同设置的参考视频；确认两边轨道信息一致后再跑。

修复过程找不到数据

可能原因：损坏文件里没有清晰的 mp4 结构，默认扫描直接放弃。 解法：加-sm强制搜索 mdat；文件里有杂散字节时用-s允许跳过未知序列。

音画不同步

可能原因：时间戳信息损坏严重，音视频时长对不齐。 解法：尝试-sv将视频拉伸匹配音频时长（beta）；效果不佳就换更接近的参考视频。

进阶旋钮

跳过未知字节序列

-s -st 1024：允许跨过无法识别的字节段继续修复，-st指定步进大小。

对齐音视频时长

-sv：把视频时长拉伸或压缩到与音频一致，beta 阶段功能，谨慎用于成片。

控制输出行为

-dw：只分析不写文件；-dr：转储修复后的轨道信息，隐含-dw；-dst <dir|file>：指定输出目录或文件名；-skip：已存在输出时直接跳过。

把风险留在录制前

录制时的习惯

• 电量充足再开拍，录完前不取存储卡
• 长内容设置自动分段，降低单次损失
• 开录前确认剩余空间，预留缓冲

备份策略

• 拍摄当天做本地加云端的双重备份
• 定期抽查备份文件能否正常播放

回到开头那个断电黑屏的文件夹：下次断电，损失最多只剩最后一段。今晚就把自动分段和双备份加上，让 untrunc 只做保险，不做主力。

关键词：视频修复、MP4修复、untrunc、MOV文件恢复、无损修复、MP4索引重建

【免费下载链接】untruncRestore a truncated mp4/mov. Improved version of ponchio/untrunc项目地址: https://gitcode.com/gh_mirrors/un/untrunc