基于Chromium的Edge/Chrome无头打印退出码21问题求助

我使用MSEdge.exe无头模式将C#应用生成的HTML输出转换为PDF，相关代码如下：

string processExe = @"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe";
string processArgs = $"--headless --run-all-compositor-stages-before-draw --virtual-time-budget=6000 --no-pdf-header-footer --print-to-pdf-no-header --print-to-pdf=\"{outputFilePath}\" \"{inputFilePath}\"";
var printPDF = Process.Start(processExe, processArgs);
printPDF.WaitForExit();

该方案已正常运行近一年，今日Edge更新后出现退出码21且无PDF生成，未找到相关文档，恳请各位提供解决方案。

核心解决方案：适配Edge新版本的参数与模式 #

1. 切换到新无头模式并清理废弃参数 #

Edge新版本逐步淘汰了旧无头模式，同时部分打印参数已被合并或废弃，调整如下：

• 替换--headless为--headless=new（新模式更稳定，兼容最新渲染逻辑）
• 移除重复的页眉页脚参数--no-pdf-header-footer和--print-to-pdf-no-header，改用统一的--no-header-footer
• 移除失效的--run-all-compositor-stages-before-draw参数（新模式下--virtual-time-budget已足够确保页面渲染完成）

修改后的代码示例：

string processExe = @"C:\Program Files\Microsoft\Edge\Application\msedge.exe";
string processArgs = $"--headless=new --print-to-pdf=\"{outputFilePath}\" --no-header-footer --virtual-time-budget=6000 \"{inputFilePath}\"";

var processStartInfo = new ProcessStartInfo(processExe, processArgs)
{
    RedirectStandardError = true,
    UseShellExecute = false,
    CreateNoWindow = true
};

using (var printPDF = Process.Start(processStartInfo))
{
    // 捕获Edge错误输出，用于精准排查问题
    string errorLog = printPDF.StandardError.ReadToEnd();
    printPDF.WaitForExit();

    if (!string.IsNullOrWhiteSpace(errorLog))
    {
        // 可将日志写入本地文件或日志系统，方便定位问题
        // File.WriteAllText(@"C:\edge_pdf_error.log", errorLog);
    }
}

2. 验证Edge路径的正确性 #

64位系统下，Edge默认安装路径为C:\Program Files\Microsoft\Edge\Application\msedge.exe，而非x86路径。若你的应用是64位进程，调用x86版本Edge可能引发兼容性问题，建议切换到对应架构的路径。

3. 排查权限与路径问题 #

• 确保应用拥有outputFilePath所在目录的写入权限，Edge更新后可能强化了文件系统访问策略
• 确认inputFilePath是有效的本地绝对路径或可访问URL，若路径含特殊字符，需确保引号包裹正确

4. 通过错误输出定位根因 #

退出码21通常对应命令行参数无效、文件访问权限不足或输入路径错误。通过重定向StandardError获取Edge的具体错误日志，是快速定位问题的关键。

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