Laravel中使用php-ffmpeg添加水印时出现Encoding failed错误求助

以下是针对你遇到的添加水印后抛出Encoding failed错误的排查与解决步骤：

1. 验证水印文件的有效性与路径 #

• 先通过代码确认水印文件存在：

  $watermarkPath = public_path('/videos/watermark.png');
  if (!file_exists($watermarkPath)) {
      die('水印文件不存在或路径错误');
  }
  

• 检查水印图片是否损坏：尝试用图片查看器打开，确认文件完整；若损坏，替换为正常的PNG图片（优先使用无透明通道问题的PNG）。

2. 开启调试模式查看FFmpeg底层错误 #

php-ffmpeg的Encoding failed是上层错误，需要查看FFmpeg执行时的具体日志才能定位问题：

use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$ffmpeg = FFMpeg::create([
    'timeout' => 3600,
    'log_level' => \FFMpeg\FFMpeg::LOG_DEBUG,
], new Logger('FFmpeg', [
    new StreamHandler(storage_path('logs/ffmpeg.log'), Logger::DEBUG)
]));

// 后续的视频处理代码...

执行后查看storage/logs/ffmpeg.log，里面会记录FFmpeg执行的命令和具体错误（比如滤镜参数错误、文件权限不足等）。

3. 检查FFmpeg的overlay滤镜支持 #

水印功能依赖FFmpeg的overlay滤镜，执行以下命令确认滤镜是否存在：

• Windows命令行：ffmpeg -filters | findstr overlay
• Linux/Mac终端：ffmpeg -filters | grep overlay
  如果没有找到overlay滤镜，说明FFmpeg编译时未包含该功能，需要重新安装带完整滤镜的FFmpeg版本。

4. 检查输出目录权限 #

确保public/videos/目录有写入权限：

• Windows：给IIS或PHP运行进程分配该目录的读写权限
• Linux/Mac：执行chmod 755 public/videos（或chmod 777，根据服务器环境调整）

5. 规范代码写法并测试 #

确保链式调用无语法问题，完整测试代码如下：

use FFMpeg\FFMpeg;
use FFMpeg\Format\Video\X264;

$format = new X264;
$ffmpeg = FFMpeg::create();
$video = $ffmpeg->open(public_path("/videos/file.mp4"));

$watermarkPath = public_path('/videos/watermark.png');
if (!file_exists($watermarkPath)) {
    throw new \RuntimeException('水印文件不存在');
}

// 添加水印滤镜
$video->filters()->watermark($watermarkPath, [
    'position' => 'relative',
    'bottom' => 50,
    'right' => 50,
]);

$output = public_path('/videos/' . time() . '.mp4');
$video->save($format, $output);

内容的提问来源于stack exchange，提问作者Jack The Baker