Skip to main content

无法启动浏览器进程

如果你收到错误信息:

🌐 If you get an error message:

Failed to launch the browser process!

TROUBLESHOOTING: https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md // or a URL pointing to this page

这意味着浏览器无法启动。最常见的原因是

🌐 it means the browser was not able to start. The most common reasons are

缺少共享库

🌐 Missing shared libraries

安装适用于你的操作系统的缺失共享库

🌐 Install the missing shared libraries for your OS.

操作系统或架构错误

🌐 Wrong OS or architecture

如果在 arm64 上运行 x64 浏览器二进制文件,或反之,你会收到此错误。
如果浏览器是为不同的操作系统或 Linux 发行版编译的,它也可能不兼容。
确保你使用的是适合你操作系统和架构的正确二进制文件。

🌐 If a x64 browser binary is run on arm64 or vice versa, you will get this error.
If the browser was compiled for a different OS or Linux distribution, it might also be incompatible. Make sure you are using the correct binary for your OS and architecture.

使用 --log=verbose 调试

🌐 Debug using --log=verbose

--log=verbose 标志添加到 npx remotion render 命令。
这将记录所有浏览器进程的输出,帮助你调试问题。

🌐 Add the --log=verbose flag to the npx remotion render command.
This will log all browser process output, helping you to debug the issue.