Azure Functions V4(.NET独立模式)运行.NET Playwright遇权限与路径问题求助

官方核心配置要求 #

• 必须使用 Azure Functions V4 .NET 独立模式，该环境已验证兼容 Playwright
• 需设置环境变量 PLAYWRIGHT_BROWSERS_PATH 指向函数应用可读写的目录，推荐用 D:\home\site\wwwroot\Browsers（原路径 D:\DWASFiles\... 权限受限，不适合）
• 禁止在函数启动时通过 PowerShell 安装浏览器/依赖：Windows 函数沙箱限制了 Get-WmiObject 这类系统级命令，且启动脚本权限不足以写入部分系统目录

针对问题的具体修复步骤 #

1. 解决权限与 Get-WmiObject 报错 #

• 放弃启动时安装浏览器的方案，改为本地预安装后随应用发布
• 在本地开发环境执行 playwright install chrome，浏览器包会下载到默认路径（通常是 %USERPROFILE%\AppData\Local\ms-playwright）
• 将该路径下的 chrome-win 文件夹复制到项目的 Browsers 目录，设置该文件夹的复制到输出目录属性为「始终复制」

2. 解决浏览器可执行文件找不到的问题 #

• 修正 PLAYWRIGHT_BROWSERS_PATH 为 D:\home\site\wwwroot\Browsers（Kudu 可访问该目录，且函数应用有读写权限）
• 在代码中显式指定浏览器路径，避免自动查找失败：

using var playwright = await Playwright.CreateAsync();
var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions
{
    ExecutablePath = Path.Combine(Environment.GetEnvironmentVariable("PLAYWRIGHT_BROWSERS_PATH"), "chrome-win", "chrome.exe"),
    Headless = true,
    Args = new[] { "--no-sandbox", "--disable-dev-shm-usage" } // 适配函数沙箱环境
});

• 验证路径正确性：通过 Kudu 确认 D:\home\site\wwwroot\Browsers\chrome-win\chrome.exe 存在，注意路径大小写（Windows 不区分，但代码尽量保持一致）

3. 额外配置注意事项 #

• 在函数应用「配置」-「应用设置」中添加 PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD = 1，禁止 Playwright 自动尝试下载浏览器
• 确保项目引用的 Playwright NuGet 包版本与预安装的浏览器版本匹配（本地执行 playwright --version 查看版本）
• 调整函数超时时间以适配网页爬取需求，在 host.json 中设置：

{
  "functionTimeout": "00:10:00"
}

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