ASP.NET Core 无头LibreOffice异步转docx为pdf时第二个文件未生成

这不是C#异步代码的语法问题，是两个核心问题共同导致的：

1. 你的ConvertToPDF方法存在逻辑缺陷：启动LibreOffice进程后，没有等待进程执行完转换任务就返回了。LibreOffice headless模式启动时如果发现没有已运行的常驻实例，会先把自身注册为常驻后台进程，此时标准输出流就会结束，你代码里的ReadToEnd()会直接返回，但实际转换任务还在后台执行，进程并未退出。
2. LibreOffice默认机制不允许多个进程共用同一个用户配置目录同时运行：当第一个转换的常驻进程还在后台运行时，你第二次启动的soffice进程不会启动新的转换实例，只会尝试把转换请求发给已存在的常驻进程，又因为前一个进程还在忙、或者IPC通信异常，第二个请求就会直接丢失，不会生成文件。

你原API里虽然写了两个await Task.Run，看似是串行执行，但因为第一个Task在转换还没完成时就已经返回了，实际两个转换请求几乎是同时打到LibreOffice上的，自然会失败。

根据业务场景二选一即可：

方案1：串行排队转换（最稳定，推荐优先使用） #

绝大多数场景下文档转换不需要追求并发，串行执行稳定性最高，不会出现多进程资源冲突问题，只需要先修复ConvertToPDF方法的逻辑缺陷，确保每个转换任务彻底完成后再执行下一个即可。

修复后的转换方法代码：

public static void ConvertToPDF(string pathToItemToConvert, string pathToLibrePortable)
{
    try
    {
        string fileName = Path.GetFileName(pathToItemToConvert);
        string fileDir = Path.GetDirectoryName(pathToItemToConvert)!;

        using var pdfProcess = new Process();
        pdfProcess.StartInfo.WindowStyle = ProcessWindowStyle.Hidden;
        pdfProcess.StartInfo.FileName = pathToLibrePortable;
        pdfProcess.StartInfo.Arguments =
            $"--norestore --nofirststartwizard --headless --convert-to pdf \"{fileName}\"";
        pdfProcess.StartInfo.WorkingDirectory = fileDir;
        pdfProcess.StartInfo.RedirectStandardOutput = true;
        pdfProcess.StartInfo.RedirectStandardError = true;
        pdfProcess.StartInfo.UseShellExecute = false;
        pdfProcess.Start();

        // 同时读取标准输出和错误流，避免缓冲区满导致进程卡死
        string output = pdfProcess.StandardOutput.ReadToEnd();
        string error = pdfProcess.StandardError.ReadToEnd();
        // 等待进程退出，设置1分钟超时（可根据实际文档大小调整），避免进程无限挂起
        if (!pdfProcess.WaitForExit(60 * 1000))
        {
            pdfProcess.Kill();
            throw new TimeoutException($"文件 {pathToItemToConvert} 转换超时");
        }
        // 校验退出码，非0即为转换失败
        if (pdfProcess.ExitCode != 0)
        {
            throw new InvalidOperationException($"文件转换失败，错误信息：{error}");
        }
    }
    catch (Exception ex)
    {
        // 替换为你的实际日志逻辑，不要直接吞异常
        throw;
    }
}

接口调用代码直接遍历待转换文件串行执行即可：

public async Task<ActionResult> ConvertDocs()
{
    var filesToConvert = new List<string> { SomeFilePath, AnotherFilePath };
    foreach (var file in filesToConvert)
    {
        await Task.Run(() => MyTools.ConvertToPDF(file, locationOfLibreOfficeSoffice));
    }
    return Ok("转换完成");
}

方案2：受控并发转换（适合批量转换场景） #

如果文件数量多、需要提升转换效率，可以通过给每个LibreOffice实例指定独立的用户配置目录，实现多进程并行转换，但必须严格控制并发数量，避免服务器内存被占满。

首先调整转换方法，支持传入独立的配置目录路径：

public static void ConvertToPDF(string pathToItemToConvert, string pathToLibrePortable, string libreUserProfilePath)
{
    try
    {
        string fileName = Path.GetFileName(pathToItemToConvert);
        string fileDir = Path.GetDirectoryName(pathToItemToConvert)!;

        using var pdfProcess = new Process();
        pdfProcess.StartInfo.WindowStyle = ProcessWindowStyle.Hidden;
        pdfProcess.StartInfo.FileName = pathToLibrePortable;
        // 追加独立用户配置参数，避免多进程锁冲突
        string profileArg = $"-env:UserInstallation=file:///{libreUserProfilePath.Replace('\\', '/')}";
        pdfProcess.StartInfo.Arguments =
            $"--norestore --nofirststartwizard --headless {profileArg} --convert-to pdf \"{fileName}\"";
        pdfProcess.StartInfo.WorkingDirectory = fileDir;
        pdfProcess.StartInfo.RedirectStandardOutput = true;
        pdfProcess.StartInfo.RedirectStandardError = true;
        pdfProcess.StartInfo.UseShellExecute = false;
        pdfProcess.Start();

        string output = pdfProcess.StandardOutput.ReadToEnd();
        string error = pdfProcess.StandardError.ReadToEnd();
        if (!pdfProcess.WaitForExit(120 * 1000)) // 并发场景下适当延长超时时间
        {
            pdfProcess.Kill();
            throw new TimeoutException($"文件 {pathToItemToConvert} 转换超时");
        }
        if (pdfProcess.ExitCode != 0)
        {
            throw new InvalidOperationException($"文件转换失败，错误信息：{error}");
        }
    }
    catch (Exception ex)
    {
        throw;
    }
}

接口调用时通过信号量控制最大并发数，每个任务分配独立临时目录：

public async Task<ActionResult> ConvertDocsParallel()
{
    var filesToConvert = new List<string> { SomeFilePath, AnotherFilePath };
    // 最大并发数建议设置为CPU核心数的1/2，单进程内存开销约300-800MB，按服务器配置调整
    using var concurrencySemaphore = new SemaphoreSlim(2);
    var convertTasks = filesToConvert.Select(async file =>
    {
        await concurrencySemaphore.WaitAsync();
        // 为每个实例创建独立临时配置目录
        var tempProfileDir = Directory.CreateTempSubdirectory("libreoffice_profile_");
        try
        {
            await Task.Run(() => MyTools.ConvertToPDF(file, locationOfLibreOfficeSoffice, tempProfileDir.FullName));
        }
        finally
        {
            // 转换完成后删除临时目录，避免垃圾文件堆积
            tempProfileDir.Delete(true);
            concurrencySemaphore.Release();
        }
    });
    await Task.WhenAll(convertTasks);
    return Ok("转换完成");
}

• 不要设置过高的并发数，LibreOffice内存开销较高，大文档转换很容易把服务器资源打满
• 必须为每个进程加超时控制，避免异常情况下soffice进程常驻后台占用资源
• 不要吞掉转换过程中的异常，否则转换失败无法排查原因
• 生产环境建议加1-2次重试机制，偶发的进程启动失败重试后基本都能成功

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