Docker中用LibreOffice转换Pages文件生成空PDF的问题求助

以下是针对你的问题的具体排查方向和解决建议：

1. 补全LibreOffice格式支持组件 #

容器中默认安装的libreoffice包可能缺少Pages格式解析所需的组件（Pages为苹果专属格式），建议安装完整的LibreOffice套件以确保格式支持：
修改Dockerfile：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
EXPOSE 80
RUN apt-get update && apt-get install -y --no-install-recommends \
    libreoffice \
    libreoffice-writer \
    libreoffice-pdfimport \
    libreoffice-core \
    && rm -rf /var/lib/apt/lists/*

2. 捕获LibreOffice的错误输出 #

你的代码未捕获转换过程的错误日志，很多格式兼容、依赖缺失的问题只会输出到stderr。修改代码捕获完整输出：

var conversionProcess = new Process
{
    StartInfo = new ProcessStartInfo
    {
        FileName = "/usr/bin/soffice",
        Arguments = conversionArgs,
        RedirectStandardError = true,
        RedirectStandardOutput = true,
        UseShellExecute = false,
        CreateNoWindow = true
    }
};

conversionProcess.Start();
var errorLog = await conversionProcess.StandardError.ReadToEndAsync();
var outputLog = await conversionProcess.StandardOutput.ReadToEndAsync();
await conversionProcess.WaitForExitAsync();

// 记录日志用于排查
Console.WriteLine($"LibreOffice stdout: {outputLog}");
Console.WriteLine($"LibreOffice stderr: {errorLog}");

3. 验证转换后文件的实际状态 #

在读取文件流前，先检查生成的PDF是否存在且非空，避免返回无效内容：

var outputFilePath = Path.ChangeExtension(inputPath, "pdf");
if (!File.Exists(outputFilePath))
{
    throw new FileNotFoundException("转换后的PDF文件不存在", outputFilePath);
}

var fileInfo = new FileInfo(outputFilePath);
if (fileInfo.Length == 0)
{
    Console.WriteLine($"生成空PDF文件，路径：{outputFilePath}");
    // 可在此处抛出异常或返回错误响应
}

// 后续读取流逻辑

4. 修正命令参数的安全构造方式 #

避免用字符串替换拼接参数（易出现空格、特殊字符解析错误），改用ArgumentList直接传递参数：

var startInfo = new ProcessStartInfo
{
    FileName = "/usr/bin/soffice",
    UseShellExecute = false,
    CreateNoWindow = true
};

startInfo.ArgumentList.Add("--norestore");
startInfo.ArgumentList.Add("--nofirststartwizard");
startInfo.ArgumentList.Add("--headless");
startInfo.ArgumentList.Add("--convert-to");
startInfo.ArgumentList.Add("pdf");
startInfo.ArgumentList.Add(inputPath);
startInfo.ArgumentList.Add("--outdir");
startInfo.ArgumentList.Add(Path.GetDirectoryName(inputPath));

var conversionProcess = new Process { StartInfo = startInfo };

5. 手动在容器内测试转换 #

进入容器直接执行转换命令，验证LibreOffice本身是否能处理Pages文件：

# 进入容器
docker exec -it <你的容器ID> bash

# 上传测试用的Pages文件到容器/tmp目录
docker cp test.pages <你的容器ID>:/tmp/

# 执行转换命令
soffice --headless --norestore --convert-to pdf /tmp/test.pages --outdir /tmp

# 检查生成的PDF状态
ls -lh /tmp/test.pdf
cat /tmp/test.pdf | head -20

如果手动转换也生成空文件，说明是LibreOffice对该Pages文件的兼容性问题；如果手动转换正常，则排查代码逻辑或权限问题。

6. 配置LibreOffice运行环境 #

无头模式下LibreOffice可能需要指定用户目录，在代码或Dockerfile中设置环境变量：

• Dockerfile中添加：ENV HOME=/tmp
• 或在ProcessStartInfo中添加：

startInfo.EnvironmentVariables["HOME"] = "/tmp";

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