Skip to main content

故障排除

浏览器依赖​

Playwright 每次运行时都会进行自检，以确保可以成功启动浏览器。如果缺少依赖项，Playwright 将打印获取它们的说明。

另请参阅 命令行工具，其中包含一个命令，可自动为 Ubuntu LTS 版本安装所有必要的依赖项。

不兼容的 Microsoft Edge / Google Chrome 策略设置​

已知当设置某些 Microsoft Edge / Google Chrome 策略设置时，Playwright 无法按预期工作。下面显示了其中一些，可能还有更多会影响 Playwright 的功能。如果您发现任何其他破坏功能的策略设置，请提交问题，我们会将其添加到此文档中。您可以通过在浏览器中运行 chrome://policy 来查看已应用策略的列表。

  • UserDataDir - 此策略用于指定用户数据目录的位置。Playwright 使用临时目录作为用户数据，因此此策略与 Playwright 不兼容。请参阅 此 bug 中的讨论。
  • ExtensionInstallForcelist - 此策略用于指定应安装的扩展列表。如果设置了此策略，Playwright 的浏览器关闭将不起作用。请参阅 此 bug 中的讨论。

Python requirements​

Playwright 需要 Python 3.7 或更高版本。

WebKit Web Inspector​

在执行期间启动 WebKit 检查器将阻止 Playwright 脚本进一步执行，并将重置预配置的用户代理和设备模拟。

这是一个已知的限制。

系统要求​

Chromium、Firefox 和 WebKit 的浏览器二进制文件可在 3 个平台（Windows、macOS、Linux）上运行：

Windows​

适用于 Windows 和 Windows Subsystem for Linux (WSL)。

macOS​

需要 11 (Big Sur) 或更高版本。

Linux​

根据您的 Linux 发行版，您可能需要安装其他依赖项才能运行浏览器。

note

仅官方支持 Ubuntu 18.04、20.04 和 22.04。

另请参阅 命令行工具，其中包含一个命令，可自动为 Ubuntu LTS 版本安装所有必要的依赖项。