ASP.NET Web API调用soffice.exe转换Docx为PDF报错：源文件无法加载

我之前碰到过几乎一模一样的问题——外部手动执行soffice命令完全正常，但放到Web API里就报文件加载失败。这类问题大多和权限、路径解析或者服务环境下的进程运行限制有关，下面是一步步的排查和修复方案：

1. 优先解决路径与权限问题 #

你的代码把文件存在C:\temp.docx，但ASP.NET Web API默认运行在IIS应用池的身份下（比如IIS APPPOOL\你的应用池名称），这个身份大概率没有C:\根目录的读写权限。另外，依赖工作目录传递文件名的方式，在服务进程里容易出现路径解析偏差，建议直接用完整文件路径作为命令参数。

修改后的代码片段： #

// 改用网站根目录下的Temp文件夹（先确保这个文件夹存在，且给应用池分配读写权限）
string tempDir = Path.Combine(Directory.GetCurrentDirectory(), "Temp");
if (!Directory.Exists(tempDir))
{
    Directory.CreateDirectory(tempDir);
}
// 用Guid生成唯一文件名，避免并发时的文件重名冲突
string filePath = Path.Combine(tempDir, $"temp_{Guid.NewGuid()}.docx");

using (Stream stream = new FileStream(filePath, FileMode.Create, FileAccess.ReadWrite))
{
    docxFile.CopyTo(stream);
}

// 直接传入完整文件路径，去掉单引号（避免路径含特殊字符时解析出错）
ProcessStartInfo procStartInfo = new("C:\\Program\\LibreOffice\\program\\soffice.exe", 
    $"--headless --convert-to pdf --nologo \"{filePath}\"")
{
    RedirectStandardInput = true,
    RedirectStandardOutput = true,
    RedirectStandardError = true,
    UseShellExecute = false,
    WindowStyle = ProcessWindowStyle.Hidden, // 服务环境下用无窗口模式更合适
    CreateNoWindow = true
};

2. 给LibreOffice加上无头模式参数 #

LibreOffice默认启动会依赖桌面会话，而Web API运行在服务环境下没有桌面上下文，加上--headless参数可以强制它在无界面模式运行，这是服务端调用的标准做法：

// 命令参数里必须加--headless
string commandArgs = $"--headless --convert-to pdf --nologo \"{filePath}\"";

3. 排查文件锁定与写入延迟 #

虽然你用了using块释放文件流，但文件系统偶尔会有写入延迟，导致LibreOffice读取时文件还没完全落地。可以在复制文件后加个短暂延迟：

using (Stream stream = new FileStream(filePath, FileMode.Create, FileAccess.ReadWrite))
{
    docxFile.CopyTo(stream);
}
// 给文件系统一点写入时间，根据文件大小调整时长
System.Threading.Thread.Sleep(500);

4. 捕获完整错误信息辅助排查 #

你的代码里只打印了错误行，但可能遗漏了关键上下文。可以把错误信息拼接起来，方便调试：

StringBuilder errorLog = new StringBuilder();
process.ErrorDataReceived += (sender, data) => 
{
    if (!string.IsNullOrEmpty(data.Data))
    {
        errorLog.AppendLine(data.Data);
        Console.WriteLine(data.Data);
    }
};

process.Start();
process.BeginOutputReadLine();
process.BeginErrorReadLine();
process.WaitForExit();

// 如果转换失败，返回详细错误给客户端
if (process.ExitCode != 0)
{
    string errorMsg = $"LibreOffice转换失败：{errorLog.ToString()}";
    Console.WriteLine(errorMsg);
    return StatusCode(500, errorMsg);
}

5. 最后别忘了清理临时文件 #

转换完成后及时删除临时的docx和pdf文件，避免磁盘空间浪费：

try
{
    string pdfPath = filePath.Replace(".docx", ".pdf");
    using FileStream fileStream = System.IO.File.Open(pdfPath, FileMode.Open);
    return File(fileStream, "application/octet-stream", Path.GetFileName(pdfPath));
}
finally
{
    // 延迟删除，确保文件流完全关闭
    System.Threading.Thread.Sleep(1000);
    if (System.IO.File.Exists(filePath))
        System.IO.File.Delete(filePath);
    string pdfPath = filePath.Replace(".docx", ".pdf");
    if (System.IO.File.Exists(pdfPath))
        System.IO.File.Delete(pdfPath);
}

按照这些步骤调整后，应该就能解决文件加载失败的问题了。

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