通过Nginx/FPM-PHP调用Unoconv在AWS环境报错求助

我来帮你一步步排查这个Unoconv在AWS上的问题，咱们从几个核心方向入手，先把最常见的坑排除掉：

1. 先确认Unoconv的核心依赖是否安装 #

Unoconv本身只是个脚本，它完全依赖LibreOffice/OpenOffice才能完成文档转码。本地Homestead环境可能默认预装了这套工具，但AWS的Ubuntu镜像大概率是没有的，这是这类问题最常见的根源：

• 先检查服务器上是否安装了LibreOffice：

  dpkg -l | grep libreoffice
  

• 如果没有任何输出，赶紧安装核心组件（按需添加writer、calc等其他组件）：

  sudo apt-get update && sudo apt-get install libreoffice-core libreoffice-writer
  

2. 验证www-data用户能否直接运行Unoconv #

PHP是通过www-data用户执行Unoconv的，咱们直接模拟这个用户的操作，能快速定位具体报错：

• 执行命令：

  sudo -u www-data /usr/bin/unoconv --version
  

• 如果输出类似unoconv 0.7的版本信息，说明Unoconv本身能正常运行；如果报错找不到soffice或类似提示，要么是LibreOffice没装，要么是soffice不在www-data的PATH环境变量里。

3. 修正PHP-FPM的环境变量 #

你之前修改了Nginx的fastcgi_params，但PHP-FPM进程自身的环境变量可能没包含必要的路径（比如LibreOffice的soffice路径）。咱们直接修改PHP-FPM的配置：

• 编辑PHP-FPM的pool配置文件（路径为/etc/php/7.0/fpm/pool.d/www.conf），添加一行：

  env[PATH] = /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/opt/node/bin
  

  确保这个PATH包含/usr/bin（因为soffice和unoconv都在这个目录下）
• 重启PHP-FPM使配置生效：

  sudo service php7.0-fpm restart
  

4. 开启Unoconv调试模式，获取详细错误 #

PHP里的模糊报错帮不上忙，咱们开启调试模式，看看Unoconv执行时的具体命令行日志：

• 修改你的PHP代码，添加调试开关：

  $unoconv = Unoconv::create([
      'unoconv.binaries' => '/usr/bin/unoconv',
  ]);
  $unoconv->setDebug(true); // 开启调试模式
  
  try {
      // 替换成你的实际转码代码
      $result = $unoconv->transcode('/path/to/your/source/file.docx', 'pdf');
  } catch (\Unoconv\Exception\RuntimeException $e) {
      // 打印详细错误信息
      var_dump($e->getMessage());
  }
  

  这里会输出Unoconv调用时的完整命令和错误日志，能直接看到是soffice启动失败、文件权限不足还是其他问题。

5. 额外注意事项 #

• 不要尝试移除Nginx里的fastcgi_param REDIRECT_STATUS 200;，这个是FastCGI规范要求的必要参数，移除必然会导致编译报错，不用管这个。
• 你之前尝试的/bin/unoconv路径不对，Unoconv确实在/usr/bin目录，保持原来的配置即可。
• 如果排查后还是权限问题，检查你的源文件和输出目录是否给了www-data读写权限：

  sudo chown -R www-data:www-data /var/www/my_proj/storage # 假设你的文件存储在storage目录
  

按照这个步骤排查，大概率能找到问题所在——我遇到过好几次都是AWS环境没装LibreOffice导致的转码失败。

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