Windows环境下Laravel调用docx2pdf转换文档失败求助

1. 调整Apache服务运行权限 #

Apache在Windows默认以Local System账户运行，该账户无桌面交互权限，而docx2pdf依赖Word/LibreOffice的COM对象，必须在桌面会话下才能正常工作：

• 打开「服务」找到Apache2.4服务，右键选「属性」
• 切换到「登录」选项卡，选择「此账户」，输入具备管理员权限且能正常打开Word的本地用户账号和密码
• 勾选「允许服务与桌面交互」，确定后重启Apache服务

2. 修正路径转义问题 #

PHP字符串里的反斜杠\会被当作转义字符，导致路径解析错误，需做转义处理：

// 方式1：用双反斜杠转义路径
$command = escapeshellcmd("C:\\Users\\sciccia\\AppData\\Local\\Programs\\Python\\Python310\\Scripts\\docx2pdf.exe c:\\test\\a.docx");
// 方式2：改用正斜杠（更简洁）
$command = escapeshellcmd("C:/Users/sciccia/AppData/Local/Programs/Python/Python310/Scripts/docx2pdf.exe c:/test/a.docx");

3. 明确指定依赖程序路径 #

Apache的环境变量和用户CMD会话不一致，可能导致docx2pdf找不到Word/LibreOffice，可强制指定依赖程序：

// 强制使用Word进行转换
$command = escapeshellcmd("C:/Users/sciccia/AppData/Local/Programs/Python/Python310/Scripts/docx2pdf.exe --use-winword c:/test/a.docx");

若用LibreOffice，需确保其路径加入系统环境变量，或在命令中直接指定LibreOffice执行文件路径。

4. 捕获错误信息定位问题 #

shell_exec仅返回命令输出，无法获取错误内容，改用exec捕获返回码和错误输出：

$command = escapeshellcmd("C:/Users/sciccia/AppData/Local/Programs/Python/Python310/Scripts/docx2pdf.exe c:/test/a.docx");
exec($command, $output, $returnVar);
// 打印返回码（非0则执行失败）和输出内容排查问题
var_dump($returnVar);
var_dump($output);

5. 检查文件与目录权限 #

• 确保Apache服务对c:\test目录有读写权限，docx文件存在且可读取，PDF输出目录（默认与docx同目录）有写入权限
• 可尝试将输出路径指定到Laravel的storage目录（需确保该目录权限正确）测试：

$inputPath = "c:/test/a.docx";
$outputPath = base_path("storage/app/public/a.pdf");
$command = escapeshellcmd("C:/Users/sciccia/AppData/Local/Programs/Python/Python310/Scripts/docx2pdf.exe $inputPath --output $outputPath");
exec($command, $output, $returnVar);

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