Windows下PHP exec调用LibreOffice soffice.exe转换文档时卡住

你遇到的这个情况我之前也碰到过——明明在CMD里跑的好好的，换成PHP exec就卡进程、疯狂生成空临时文件夹，本质上还是旧版本LibreOffice（5.4.6）对Windows会话环境和权限的特殊依赖导致的，哪怕是同一用户上下文也会有差异。下面给你拆解原因和对应的解决办法：

1. 核心原因：LibreOffice无头模式依赖桌面会话 #

虽然你加了--headless参数，但5.x版本的LibreOffice并没有完全脱离Windows的桌面会话环境。你手动在CMD里执行时，是在用户登录后的完整桌面会话中运行的；但PHP的exec是在IIS应用池的进程上下文里，默认没有加载完整的桌面交互环境，导致soffice.exe卡在初始化阶段，不断生成临时配置文件夹（就是你看到的lu*.tmp）却无法继续执行转换。

解决办法： #

• 给IIS应用池的运行用户开启桌面交互权限：
  打开「服务」管理器，找到World Wide Web Publishing Service（W3SVC），右键→属性→登录标签页，勾选「允许服务与桌面交互」，然后重启服务。
• 更稳妥的方式：把应用池的运行用户改成你手动测试时使用的登录用户，确保会话环境完全一致。

2. 临时目录的权限细节问题 #

虽然sys_get_temp_dir()指向C:\Windows\Temp，但IIS应用池用户对这个目录的权限和你手动登录时的用户权限有细微差异——比如可能缺少删除临时文件夹、写入PDF文件的权限，导致进程卡在收尾阶段。

解决办法： #

• 给C:\Windows\Temp目录添加IIS应用池用户（格式是IIS AppPool\你的应用池名称）的完全控制权限，至少要包含读取、写入、创建/删除子文件夹的权限。
• 可以试试自定义临时目录：在你的网站根目录下新建一个temp文件夹，给应用池用户权限，然后把-outdir改成这个路径，避开系统Temp目录的权限限制。

3. 残留进程阻塞新请求 #

之前卡住的soffice.exe进程如果没有被彻底终止，会占用LibreOffice的资源，导致后续的转换请求全部阻塞。那些lu*.tmp文件夹就是LibreOffice的临时配置目录，进程卡住时这些目录不会被自动清理。

解决办法： #

• 在调用转换命令前，先杀掉所有残留的soffice.exe进程：

  // 先清理残留进程
  exec("taskkill /f /im soffice.exe");
  // 再执行转换命令
  $cmd = "soffice.exe --headless -convert-to pdf -outdir ".sys_get_temp_dir()." ".$workingdoc;
  exec($cmd);
  

• 给soffice.exe指定专属配置目录，避免和其他进程冲突：

  $customConfigDir = 'C:\inetpub\wwwroot\your-site\libreoffice-config';
  // 确保目录存在并给应用池用户权限
  if (!is_dir($customConfigDir)) mkdir($customConfigDir);
  $cmd = "soffice.exe --headless -env:UserInstallation=file:///$customConfigDir -convert-to pdf -outdir ".sys_get_temp_dir()." ".$workingdoc;
  exec($cmd);
  

4. 捕获命令输出排查问题 #

你现在的exec调用没有捕获任何输出和错误信息，很难定位具体的失败点。建议修改代码，捕获命令的输出和返回码：

$output = [];
$returnVar = 0;
$cmd = "soffice.exe --headless -convert-to pdf -outdir ".sys_get_temp_dir()." ".$workingdoc;
exec($cmd, $output, $returnVar);

// 打印输出和返回码，方便排查
var_dump($output);
var_dump($returnVar);

返回码非0时，输出数组里通常会有LibreOffice的错误提示，能帮你更快定位问题。

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