如何在Azure函数中向wkhtmltopdf.exe传入HTML字符串命令行参数？

1. 通过标准输入（Stdin）传递HTML字符串（推荐方案） #

wkhtmltopdf原生支持从标准输入读取HTML内容，只需将输入源指定为-即可，这种方式避免了命令行长度限制和字符转义问题，非常适合处理较长的HTML字符串。

以C# Azure函数为例，代码示例如下：

using System.Diagnostics;
using System.IO;

public async Task<byte[]> GeneratePdfFromHtml(string htmlContent)
{
    // 假设wkhtmltopdf.exe位于函数的bin目录下
    string wkhtmlPath = Path.Combine(Environment.CurrentDirectory, "bin", "wkhtmltopdf.exe");
    
    var processStartInfo = new ProcessStartInfo
    {
        FileName = wkhtmlPath,
        Arguments = "- -", // 第一个-表示从stdin读HTML，第二个-表示将PDF输出到stdout
        RedirectStandardInput = true,
        RedirectStandardOutput = true,
        RedirectStandardError = true,
        UseShellExecute = false,
        CreateNoWindow = true
    };

    using (var process = Process.Start(processStartInfo))
    {
        // 将HTML字符串写入进程的标准输入
        await process.StandardInput.WriteAsync(htmlContent);
        process.StandardInput.Close(); // 关闭输入流，告知进程输入结束

        // 读取生成的PDF字节流
        var pdfBytes = await process.StandardOutput.ReadToEndAsync();
        await process.WaitForExitAsync();

        if (process.ExitCode != 0)
        {
            string error = await process.StandardError.ReadToEndAsync();
            throw new Exception($"wkhtmltopdf执行失败: {error}");
        }

        return Convert.FromBase64String(pdfBytes);
    }
}

如果是Python Azure函数，示例代码：

import subprocess
import os

def generate_pdf_from_html(html_content):
    wkhtml_path = os.path.join(os.getcwd(), "bin", "wkhtmltopdf")  # Linux环境下无.exe后缀
    cmd = [wkhtml_path, "-", "-"]
    
    result = subprocess.run(
        cmd,
        input=html_content.encode("utf-8"),
        capture_output=True,
        text=False
    )
    
    if result.returncode != 0:
        raise Exception(f"wkhtmltopdf执行失败: {result.stderr.decode('utf-8')}")
    
    return result.stdout

2. 临时文件中转方案 #

如果因环境限制无法使用标准输入，可以将HTML字符串写入临时文件，再将文件路径作为参数传给wkhtmltopdf，生成PDF后删除临时文件。

C#示例：

using System.IO;
using System.Diagnostics;

public async Task<byte[]> GeneratePdfWithTempFile(string htmlContent)
{
    string tempHtmlPath = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.html");
    string tempPdfPath = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.pdf");
    string wkhtmlPath = Path.Combine(Environment.CurrentDirectory, "bin", "wkhtmltopdf.exe");

    try
    {
        // 写入临时HTML文件
        await File.WriteAllTextAsync(tempHtmlPath, htmlContent);

        var processStartInfo = new ProcessStartInfo
        {
            FileName = wkhtmlPath,
            Arguments = $"\"{tempHtmlPath}\" \"{tempPdfPath}\"",
            UseShellExecute = false,
            CreateNoWindow = true
        };

        using (var process = Process.Start(processStartInfo))
        {
            await process.WaitForExitAsync();
            if (process.ExitCode != 0)
            {
                string error = await process.StandardError.ReadToEndAsync();
                throw new Exception($"wkhtmltopdf执行失败: {error}");
            }
        }

        // 读取PDF字节并返回
        return await File.ReadAllBytesAsync(tempPdfPath);
    }
    finally
    {
        // 清理临时文件
        if (File.Exists(tempHtmlPath)) File.Delete(tempHtmlPath);
        if (File.Exists(tempPdfPath)) File.Delete(tempPdfPath);
    }
}

3. 直接命令行参数传递（不推荐） #

虽然可以通过echo等命令将HTML字符串通过管道传给wkhtmltopdf，但这种方式会受限于命令行长度限制，且HTML中的特殊字符（如引号、换行符）需要复杂的转义，极易出错，仅适合极短的HTML内容。

示例（Windows环境）：

echo "<html><body>Hello</body></html>" | wkhtmltopdf.exe - output.pdf

注意事项 #

• Azure函数部署时，需将wkhtmltopdf可执行文件（及依赖库，如Linux环境下的libfontconfig、libx11等）包含在部署包中，放置在函数的bin目录下。
• Linux环境的Azure函数需要确保wkhtmltopdf有可执行权限（可通过chmod +x wkhtmltopdf设置）。
• 处理大HTML字符串时，优先选择标准输入方案，避免临时文件的IO开销和清理问题。

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