按阶段排查问题

现象	先检查	下一步
401 / 403	API Key、同项目 ID、服务域名、功能权限	修正配置，重复重试不会获得权限
创建超时	已分配 ID 和控制台会话状态	重试前检查，关闭遗留会话
CDP 连接失败	会话 active、返回地址可达、代理/防火墙支持 WebSocket	原样使用返回地址，不记录其中的凭据
CDP 方法不支持	引擎和具体方法	在 Chromium 复现并报告方法名
导航超时	目标可达性、代理出口、页面就绪条件	缩小到单 URL 和具体选择器
Context locked	持有会话与异步关闭进度	等待释放，不强制解锁正在写入的会话
代理 407	服务商凭据	验证上游配置，不打印密钥
Web Fetch 报错	HTTP 状态、结构化错误、request_id	按 Web Fetch 错误说明处理

有用的问题报告

包含时间及时区、国内/国际服务、SDK/CLI 版本、浏览器模式、操作、脱敏错误、会话 ID 或 request_id、最小复现，以及预期和实际行为。去掉 API Key、带认证信息的连接 URL、代理密码、Cookie 和页面个人信息。

View 页面正常不证明本地网络能打开自动化 WebSocket；会话 ready 不证明目标网站允许访问；关闭请求成功不证明 Context 锁已经释放。

从最小 Playwright 示例开始逐项加入功能，缩小复现时仍保留清理流程。

现象	先检查	下一步
401 / 403	API Key、同项目 ID、服务域名、功能权限	修正配置，重复重试不会获得权限
创建超时	已分配 ID 和控制台会话状态	重试前检查，关闭遗留会话
CDP 连接失败	会话 active、返回地址可达、代理/防火墙支持 WebSocket	原样使用返回地址，不记录其中的凭据
CDP 方法不支持	引擎和具体方法	在 Chromium 复现并报告方法名
导航超时	目标可达性、代理出口、页面就绪条件	缩小到单 URL 和具体选择器
Context locked	持有会话与异步关闭进度	等待释放，不强制解锁正在写入的会话
代理 407	服务商凭据	验证上游配置，不打印密钥
Web Fetch 报错	HTTP 状态、结构化错误、request_id	按 Web Fetch 错误说明处理

View 页面正常不证明本地网络能打开自动化 WebSocket；会话 ready 不证明目标网站允许访问；关闭请求成功不证明 Context 锁已经释放。

从最小 Playwright 示例开始逐项加入功能，缩小复现时仍保留清理流程。