Windows下Node.js 20.14.0安装Playwright时FFmpeg下载失败求助

我使用搭载Node LTS 20.14.0的Windows笔记本，执行npm init playwright@latest安装Playwright时，持续出现FFmpeg下载失败的错误，错误信息如下：

Downloading browsers (npx playwright install)…
Downloading FFMPEG playwright build v1009 from https://playwright.azureedge.net/builds/ffmpeg/1009/ffmpeg-win64.zip
1.4 MiB [================    ] 78% 0.0sError: Download failed: server closed connection. URL: https://playwright.azureedge.net/builds/ffmpeg/1009/ffmpeg-win64.zip
    at IncomingMessage.<anonymous> (C:\Users\...\e2e\node_modules\playwright-core\lib\server\registry\oopDownloadBrowserMain.js:89:24)
    at IncomingMessage.emit (node:events:519:28)
    at emitErrorNT (node:internal/streams/destroy:169:8)
    at emitErrorCloseNT (node:internal/streams/destroy:128:3)
    at process.processTicksAndRejections (node:internal/process/task_queues:82:21)
Downloading FFMPEG playwright build v1009 from https://playwright-akamai.azureedge.net/builds/ffmpeg/1009/ffmpeg-win64.zip
1.4 MiB [==============      ] 71% 0.1sError: Download failed: server closed connection. URL: https://playwright-akamai.azureedge.net/builds/ffmpeg/1009/ffmpeg-win64.zip
    at IncomingMessage.<anonymous> (C:\Users\...\e2e\node_modules\playwright-core\lib\server\registry\oopDownloadBrowserMain.js:89:24)
    at IncomingMessage.emit (node:events:519:28)
    at emitErrorNT (node:internal/streams/destroy:169:8)
    at emitErrorCloseNT (node:internal/streams/destroy:128:3)
    at process.processTicksAndRejections (node:internal/process/task_queues:82:21)
Downloading FFMPEG playwright build v1009 from https://playwright-verizon.azureedge.net/builds/ffmpeg/1009/ffmpeg-win64.zip
1.4 MiB [===============     ] 74% 0.1sError: Download failed: server closed connection. URL: https://playwright-verizon.azureedge.net/builds/ffmpeg/1009/ffmpeg-win64.zip
    at IncomingMessage.<anonymous> (C:\Users\...\e2e\node_modules\playwright-core\lib\server\registry\oopDownloadBrowserMain.js:89:24)
    at IncomingMessage.emit (node:events:519:28)
    at emitErrorNT (node:internal/streams/destroy:169:8)
    at emitErrorCloseNT (node:internal/streams/destroy:128:3)
    at process.processTicksAndRejections (node:internal/process/task_queues:82:21)
Failed to install browsers
Error: Failed to download FFMPEG playwright build v1009, caused by
Error: Download failure, code=1
    at ChildProcess.<anonymous> (C:\Users\...\e2e\node_modules\playwright-core\lib\server\registry\browserFetcher.js:91:16)
    at ChildProcess.emit (node:events:519:28)
    at ChildProcess._handle.onexit (node:internal/child_process:294:12)
Error: Command failed: npx playwright install
    at genericNodeError (node:internal/errors:984:15)
    at wrappedFn (node:internal/errors:538:14)
    at checkExecSyncError (node:child_process:890:11)
    at execSync (node:child_process:962:15)
    at executeCommands (C:\Users\...\AppData\Local\npm-cache\_npx\d352e76cc6b4974c\node_modules\create-playwright\lib\index.js:4519:39)
    at Generator.run (C:\Users\...\AppData\Local\npm-cache\_npx\d352e76cc6b4974c\node_modules\create-playwright\lib\index.js:4690:5)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async C:\Users\...\AppData\Local\npm-cache\_npx\d352e76cc6b4974c\node_modules\create-playwright\lib\index.js:4981:3 {
  status: 1,
  signal: null,
  output: [ null, null, null ],
  pid: 23804,
  stdout: null,
  stderr: null
}

解决方法 #

• 手动下载FFmpeg包：复制错误日志里的FFmpeg下载链接（比如https://playwright.azureedge.net/builds/ffmpeg/1009/ffmpeg-win64.zip），用浏览器或第三方下载工具完成下载。
• 放置到指定目录：Windows下，找到路径C:\Users\<你的用户名>\AppData\Local\ms-playwright，创建ffmpeg-1009文件夹（版本号要和日志里的一致），将下载的压缩包解压后全部文件放入该文件夹。
• 跳过自动下载执行安装：执行npm init playwright@latest -- --install-deps仅安装依赖，不自动下载浏览器和FFmpeg；或直接运行npx playwright install --skip-browsers触发Playwright检测本地已有的FFmpeg文件。
• 排查网络问题：关闭代理、防火墙，或切换到更稳定的网络（如手机热点），重新运行安装命令。
• 清理npm缓存：执行npm cache clean --force清理缓存后，再重新执行npm init playwright@latest。

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