Laravel中使用ProtoneMedia/LaravelFFMpeg上传部分视频出现EncodingException编码失败问题

这种仅部分视频上传失败的情况，大概率是视频本身的兼容性问题、临时文件处理异常，或者FFmpeg参数配置不足导致的，结合你的代码和错误信息，我来拆解具体原因和解决办法：

一、可能的原因 #

1. 视频文件本身存在兼容性问题
   部分视频可能采用了FFmpeg 4.3.2（你的版本）未完全支持的编码格式、非标准封装容器，或者视频文件本身有损坏、元数据异常。比如有些MP4视频可能用了老旧的编码变种，或者封装了FFmpeg默认不识别的流信息。
2. 临时文件路径传递异常
   错误信息里显示FFmpeg的输入参数变成了[object] (ProtoneMedia\LaravelFFMpeg\Exporters\EncodingException(...))，这说明临时文件的路径没有被正确解析，大概率是temp_disk配置有问题，或者临时文件存储后无法被FFmpeg读取。
3. FFmpeg默认参数不兼容
   你的代码里没有指定任何编码参数，LaravelFFMpeg会使用默认配置，但部分特殊视频需要明确指定编码器、比特率等参数才能正常处理。

二、针对性解决方案 #

1. 先排查视频本身的问题 #

先脱离Laravel，直接在服务器上用FFmpeg手动测试失败的视频，定位是否是视频的问题：

• 尝试复制视频流（不重新编码），看是否能正常执行：

  /usr/bin/ffmpeg -i /path/to/test-video2.mp4 -vcodec copy -acodec copy test-output.mp4
  

  如果执行报错，说明视频本身有损坏或者编码不兼容。
• 查看视频的详细编码信息，对比成功的视频找差异：

  /usr/bin/ffprobe -v quiet -print_format json -show_format -show_streams /path/to/test-video2.mp4
  

  重点看codec_name（视频/音频编码）、format_name（容器格式）字段，比如失败的视频可能用了hevc（H.265）但你的FFmpeg配置未完全支持，或者音频用了alac这类小众编码。

2. 修复临时文件处理问题 #

• 检查config('temp_disk')对应的磁盘配置是否正确，确保临时文件存储路径存在且FFmpeg有读取权限。
• 在代码中添加临时文件存在性校验，排查路径是否正确：

  $tmpPath = $file->store('/tmp', 'temp_disk');
  $tempDisk = Storage::disk('temp_disk');
  
  // 校验临时文件是否存在
  if (!$tempDisk->exists($tmpPath)) {
      throw new \RuntimeException('临时文件创建失败，请检查temp_disk配置');
  }
  
  // 打印临时文件的绝对路径，方便排查
  \Log::info('临时文件绝对路径：' . $tempDisk->path($tmpPath));
  

3. 明确指定FFmpeg编码参数 #

给FFmpeg指定明确的编码器和参数，避免默认配置不兼容的问题：

$ffMpeg = FFMpeg::fromDisk(config('temp_disk'))->open($tmpPath);
$dimension = $ffMpeg->getVideoStream()->getDimensions();

// 视频导出时明确指定编码器和参数
$ffMpeg->export()
    ->toDisk($mediadisk)
    ->setVideoCodec('libx264') // 通用H.264编码器，兼容性最好
    ->setAudioCodec('aac') // 通用AAC音频编码器
    ->setVideoBitrate('1500k') // 根据需求调整比特率
    ->save($videoPath = "{$pathPrefix}/videos/{$mediaName}");

// 截图时明确格式参数
$ffMpeg->getFrameFromSeconds(5)
    ->export()
    ->toDisk($thumbnailDisk = config('asset-inventory.image_disk'))
    ->setFrameFormat('png')
    ->save($thumbnailPath = $pathPrefix . '/media/thumbnail/' . $mediaName . '.png');

4. 升级FFmpeg版本 #

你的FFmpeg版本是4.3.2（2021年发布），比较老旧，很多新的编码和容器支持是在后续版本中添加的。尝试升级到最新稳定版（比如6.x系列），能解决不少兼容性问题。

额外提示 #

一定要去查看Laravel的日志文件（比如storage/logs/laravel.log），里面应该有完整的FFmpeg执行命令和详细错误输出，这是定位问题最关键的信息——比如FFmpeg返回的具体错误提示（如Invalid data found when processing input），能直接告诉你是视频损坏还是编码不支持。

内容的提问来源于stack exchange，提问作者mthh