Playwright MCP 项目中 Edge 浏览器启动问题分析与解决方案

Playwright MCP 是一个基于 Playwright 的微服务工具，用于提供浏览器自动化能力。近期在项目使用过程中，部分开发者遇到了 Edge 浏览器启动失败的问题，本文将深入分析问题原因并提供解决方案。

问题现象

开发者在使用 Playwright MCP 时，尝试通过 CLI 参数指定 Edge 浏览器路径或直接使用 msedge 浏览器时遇到了启动失败的情况。错误信息显示"Target page, context or browser has been closed"，但并未提供足够详细的错误原因。

问题分析

从错误日志中可以看到几个关键点：

1. 浏览器进程确实被启动了（pid=20128）
2. 启动参数包含了标准的 Playwright 自动化参数
3. 浏览器在初始化阶段就意外关闭了

这种问题通常与以下几个因素有关：

• 浏览器版本与 Playwright 不兼容
• 权限问题导致浏览器无法正常初始化
• 特定的安全策略阻止了自动化操作

解决方案

1. 正确指定浏览器参数

确保使用正确的参数格式：

{
  "servers": {
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--browser",
        "msedge",
        "--executable-path",
        "C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe"
      ]
    }
  }
}

注意参数必须分开为独立数组项，不能合并为一个字符串。

2. 检查浏览器版本

确保安装的是 Edge 的稳定版本，并且版本不要太旧。Playwright 对较新版本的浏览器支持更好。

3. 尝试禁用沙箱模式

在启动参数中添加：

"--no-sandbox"

但请注意这会降低安全性，仅建议在测试环境中使用。

4. 检查用户数据目录权限

错误日志显示使用了临时用户数据目录：

C:\Users\<user>\AppData\Local\ms-playwright\mcp-chromium-profile

确保该目录有正确的读写权限，或尝试指定其他目录：

"--user-data-dir=/path/to/custom/directory"

替代方案

如果上述方法都无法解决问题，可以考虑：

1. 使用 Playwright 自带的 Chromium 浏览器而非系统 Edge
2. 降级到 Playwright MCP 的早期稳定版本
3. 在容器化环境中运行测试，避免本地环境差异

总结

Playwright MCP 的浏览器启动问题通常与参数格式或环境配置有关。通过正确指定参数、检查权限和版本兼容性，大多数问题都能得到解决。对于持续出现的问题，建议收集更详细的日志并向社区反馈。