Chrome无头浏览打印PDF功能在C# Web应用失效，命令行可正常运行

这种情况我碰到过好几次，核心原因大多是Web应用的运行环境和你手动在命令行执行的环境不一样，下面是几个最可能的排查方向和解决办法：

1. 确保Chrome路径是绝对路径 #

命令行里能直接用chrome是因为系统PATH环境变量包含了Chrome的安装目录，但Web应用的进程（比如IIS应用池、ASP.NET Core的托管进程）的PATH变量可能没包含这个路径，或者工作目录不同导致相对路径失效。

解决办法：

• 把命令里的chrome替换成Chrome可执行文件的绝对路径，比如：

  "C:\Program Files\Google\Chrome\Application\chrome.exe" --headless --print-to-pdf="C:\output\test.pdf" "https://example.com"
  

• 如果是64位系统，也可能在C:\Program Files (x86)\Google\Chrome\Application\chrome.exe，可以先确认Chrome的实际安装路径。

2. 检查Web应用的运行权限 #

Web应用通常以特定身份运行（比如IIS的ApplicationPoolIdentity，或者本地服务账户），这个账户可能没有：

• 访问Chrome可执行文件的权限
• 写入PDF输出目录的权限

解决办法：

• 右键Chrome安装目录（比如C:\Program Files\Google\Chrome），选择「属性」→「安全」，添加Web应用运行的账户，给它读取和执行的权限。
• 对PDF输出目录，给该账户写入权限。如果是临时目录，也可以用Path.GetTempPath()来获取系统临时目录，这个目录通常所有账户都有写入权限。

3. 明确设置进程的工作目录 #

C#里启动进程时，如果没有指定工作目录，默认会用Web应用的根目录（比如IIS的wwwroot），这可能导致命令里的相对路径（比如输出PDF的相对路径）失效。

解决办法：
在启动Process时，设置WorkingDirectory为合适的路径，比如命令行执行时的工作目录，或者Chrome的安装目录：

var processStartInfo = new ProcessStartInfo
{
    FileName = @"C:\Program Files\Google\Chrome\Application\chrome.exe",
    Arguments = "--headless --print-to-pdf=\"C:\output\test.pdf\" \"https://example.com\"",
    WorkingDirectory = @"C:\Program Files\Google\Chrome\Application",
    UseShellExecute = false,
    RedirectStandardOutput = true,
    RedirectStandardError = true
};

using var process = Process.Start(processStartInfo);
process.WaitForExit();

4. 捕获并查看错误输出 #

有时候「找不到指定文件」的提示可能有误导性，最好捕获进程的标准错误输出，看看具体是哪里出问题：

using var process = Process.Start(processStartInfo);
var errorOutput = process.StandardError.ReadToEnd();
var standardOutput = process.StandardOutput.ReadToEnd();
process.WaitForExit();

// 输出错误信息到日志或者控制台
Console.WriteLine($"Error: {errorOutput}");
Console.WriteLine($"Output: {standardOutput}");

这样能拿到更详细的错误，比如是Chrome找不到，还是输出目录没有权限，或者参数格式有问题。

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