3步解决DouyinLiveRecorder TS转MP4失败问题：从原理到实战修复指南

你是否遇到过使用DouyinLiveRecorder录制直播后，TS文件转MP4时出现"转码失败"或"文件损坏"的问题？本文将从技术原理到实际操作，帮你彻底解决这一痛点。读完本文你将获得：

• 理解TS与MP4格式转换的核心机制
• 掌握3种快速排查转码失败的方法
• 学会修改配置文件优化转换参数
• 获取自动化批量转换解决方案

转码功能工作原理

DouyinLiveRecorder的TS转MP4功能由main.py中的converts_mp4()函数实现，通过调用FFmpeg工具完成格式转换。转换过程分为两种模式：

快速复制模式

当配置文件中converts_to_h264=false时，采用流复制模式：

ffmpeg_command = [
    "ffmpeg", "-i", converts_file_path,
    "-c:v", "copy",  # 视频流直接复制
    "-c:a", "copy",  # 音频流直接复制
    "-f", "mp4", output_file_path
]

这种模式速度快但可能因TS封装格式问题导致失败。

重新编码模式

当converts_to_h264=true时，会进行H.264重新编码：

ffmpeg_command = [
    "ffmpeg", "-i", converts_file_path,
    "-c:v", "libx264",  # 使用H.264编码器
    "-preset", "veryfast",
    "-crf", "23",  # 质量控制参数
    "-vf", "format=yuv420p",  # 确保兼容性
    "-c:a", "copy",
    "-f", "mp4", output_file_path
]

该模式兼容性更好但耗时较长，相关代码位于main.py。

常见失败原因与解决方案

1. FFmpeg缺失或版本过低

症状：日志中出现"ffmpeg: command not found"或编码错误
解决步骤：

1. 运行ffmpeg_install.py自动安装：

   python ffmpeg_install.py
   

2. 验证安装结果：

   ffmpeg -version
   

3. 如手动安装，需确保FFmpeg路径已添加到系统环境变量

2. 转换参数配置不当

症状：转换过程中卡住或生成0KB文件
解决方案：修改config/config.ini中的转码参数：

[Video]
converts_to_mp4=true
converts_to_h264=true
# 降低CRF值可提高质量但增加文件大小
crf_value=25
# 调整编码器预设（ultrafast < veryfast < medium < slow）
preset=medium

提示：CRF值范围18-28，数值越小质量越高，建议从23开始尝试

3. TS源文件损坏或不完整

症状：转换失败并提示"Invalid data found when processing input"
解决流程：

1. 检查录制文件大小，确认录制过程未中断
2. 使用FFmpeg修复损坏的TS文件：

   ffmpeg -i damaged.ts -c copy -bsf:v h264_mp4toannexb fixed.ts
   

3. 重新尝试转换修复后的文件

高级优化技巧

批量转换脚本

创建batch_convert.py处理多个TS文件：

import os
from douyinliverecorder.utils import logger
from main import converts_mp4

def batch_convert(ts_dir):
    for root, dirs, files in os.walk(ts_dir):
        for file in files:
            if file.endswith('.ts'):
                ts_path = os.path.join(root, file)
                logger.info(f"开始转换: {ts_path}")
                converts_mp4(ts_path, is_original_delete=True)

if __name__ == "__main__":
    batch_convert("./downloads")

自定义转码参数

修改main.py调整编码速度与质量平衡：

# 高质量设置（ slower, better quality ）
"-preset", "slow",
"-crf", "20",

# 快速设置（ faster, larger file size ）
"-preset", "ultrafast",
"-crf", "28",

自动化转换工作流

推荐配置config/config.ini实现全自动处理：

[Video]
# 录制完成后自动转MP4
converts_to_mp4=true
# 启用分段录制避免大文件问题
split_video_by_time=true
split_time=3600  # 每小时分段
# 自动删除原始TS文件
delete_origin_file=true

工作流程图：

graph TD
    A[开始录制] --> B[生成TS文件]
    B --> C{录制结束?}
    C -->|是| D[调用converts_mp4()]
    C -->|否| B
    D --> E[检查转换结果]
    E -->|成功| F[删除TS文件]
    E -->|失败| G[记录错误日志]

问题排查工具包

1. 日志分析：查看程序日志定位具体错误：

   grep "ffmpeg" logs/app.log
   

2. FFmpeg调试：添加详细日志输出重定向：

   # 修改main.py中subprocess调用
   _output = subprocess.check_output(
       ffmpeg_command, 
       stderr=subprocess.STDOUT, 
       startupinfo=get_startup_info(os_type)
   )
   with open("ffmpeg_debug.log", "w") as f:
       f.write(_output.decode())
   

3. 配置检查工具：运行内置配置验证：

   python main.py --check-config
   

通过以上方法，90%的TS转MP4问题都能得到解决。如遇到复杂情况，可提供config/config.ini配置和转换日志，在项目Issue中获取进一步支持。记住定期同步项目更新，许多转换问题会通过版本迭代得到优化。