Antigravity IDE 调用 Browser Agent 提示 Error during tool execution、405 Method Not Allowed错误的排查解决方法

405 Method Not Allowed 错误是 Antigravity IDE 的 Browser Agent 常见问题。这个错误表明 IDE 向浏览器控制服务发起的 HTTP 请求被拒绝，通常与 Chrome 实例管理和扩展配置有关。

根本原因分析

405 错误在此场景下并非传统意义上的 HTTP 协议问题，而是 Antigravity 的本地浏览器控制接口未正确响应 IDE 的自动化请求，主要诱因包括：

Chrome 实例错误：使用了个人 Chrome 而非 Antigravity 启动的专用托管实例
Browser Control 扩展未安装/失效：该扩展是自动化核心，负责处理 IDE 的浏览器操作请求
代理干扰：ShadowRocket 等代理软件可能拦截 IDE 与本地 Chrome 的通信
配置缓存损坏：Chrome 配置文件或扩展状态异常

解决方案（按优先级排序）

1. 安装/验证 Browser Control 扩展（最关键）

这是大部分用户提到的首要检查点。

操作步骤：

确保本地 Chrome 完全退出（Cmd+Q）
在 Antigravity 中点击 Chrome 图标，让其自动启动专用 Chrome 实例
访问 chrome://extensions/，确认 "Antigravity Browser Extension" 已安装且启用
使用与 IDE 登录相同的 Google 账号

2. 重置 Chrome 配置文件

如果扩展反复消失或无法安装，需重置 Antigravity 的 Chrome 配置。

macOS 操作：

# 完全退出 Antigravity 和 Chrome
rm -rf ~/Library/Application\ Support/Google/Chrome/AntigravityProfile
# 重启 Antigravity，点击 Chrome 图标重新生成配置

3. 处理代理冲突

ShadowRocket 隧道代理很可能是 405 错误的直接原因。

解决方法：

在 ShadowRocket 中配置绕过本地地址（Bypass Localhost/127.0.0.1）
或临时关闭系统代理，仅保留浏览器插件代理
验证：在终端执行 curl -v http://127.0.0.1:9222/json/version，应返回 Chrome 调试端口信息而非 405

4. 检查调试端口

Antigravity 依赖 Chrome 的远程调试协议。

手动验证：

# 启动 Chrome 调试模式（如 IDE 未自动处理）
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir=/tmp/antigravity-chrome-profile

然后在 Antigravity 中重新尝试浏览器操作。

5. 禁用冲突扩展

广告拦截器（uBlock Origin）和隐私工具会阻断自动化请求。

操作：

在 Antigravity 专用 Chrome 中，禁用所有非必要扩展
保留仅 Antigravity Browser Control

快速诊断流程

检查项	命令/操作	正常结果
Chrome 调试端口	`curl http://localhost:9222/json`	返回 JSON 数据
扩展状态	访问 `chrome://extensions`	Antigravity Browser Extension 显示"已开启"
代理设置	关闭代理后重试	405 错误消失

如果以上步骤均无效，根据官方建议，尝试 重启 Agent 服务：

打开命令面板（Cmd+Shift+P）
输入 "Restart Agent Service"
等待 10-15 秒后重试

此问题 90% 可通过使用 IDE 启动的 Chrome + 正确安装扩展 + 处理代理冲突解决，无需额外配置 MCP Server，这是 Antigravity 的原生功能。