chromedp 比 Rod 更适合多数 Go Web 测试场景，因其原生 Go 实现、无外部依赖、启动快、内存可控、CI 稳定性高、上下文取消自然、加载控制精细、错误容忍强、截图/PDF 更可靠。
chromedp 为什么比 Rod 更适合多数 Go Web 测试场景
chromedp 是原生 Go 实现的 Chrome DevTools Protocol 客户端，没有外部二进制依赖、启动快、内存可控；Rod 依赖本地或远程 Chrome 进程 + 额外的 rod-bin 下载逻辑，在 CI 环境里容易因版本不一致或权限问题失败。chromedp.NewExecAllocator 可直接复用系统 Chrome 或指定 --headless=new 启动，而 Rod 的 rod.New().MustConnect() 默认尝试自动下载浏览器，CI 中常卡在 failed to download browser。
实操建议：
- CI 中优先用 chromedp，通过环境变量控制 Chrome 路径：
CHROME_BIN=/usr/bin/chromium - 避免 Rod 的自动下载行为：显式传入已安装的浏览器路径，例如
rod.New().ControlURL("http://127.0.0.1:9222").MustConnect()，再手动用chromium --remote-debugging-port=9222 --headless=new启动 - chromedp 的上下文取消机制更自然——每个任务用
context.WithTimeout包裹，超时后自动终止 DevTools 会话；Rod 的.Timeout()是链式调用，容易漏写或覆盖
chromedp.Navigate 失败但没报错？检查页面加载模式
chromedp.Navigate 默认不等待页面“完全加载”，它只触发导航，然后立刻返回。如果你紧接着执行 chromedp.WaitVisible 却找不到元素，大概率是页面 DOM 还没渲染完，或者 JS 尚未执行完毕。
常见错误现象：chromedp.Text 返回空字符串、chromedp.Value 拿不到表单值、截图里显示白屏
立即学习“go语言免费学习笔记（深入）”；
实操建议：
- 显式加加载等待：
chromedp.WaitReady(`body`, chromedp.ByQuery)或更稳妥地等网络空闲：chromedp.WaitNotPresent(`#loading-spinner`, chromedp.ByQuery) - 对 SPA 页面，别只等 DOM，要等 JS 初始化完成：用
chromedp.Evaluate(`window.APP_READY === true`, &ready)配合轮询 - 禁用图片/字体加速测试：
chromedp.Flag("blink-settings", "imagesEnabled=false")，减少非关键资源干扰
如何让 chromedp 测试不因弹窗、证书错误、重定向挂掉
真实 Web 页面常有 alert()、自签名 HTTPS、302 跳转、跨域 iframe，chromedp 默认行为是阻塞或 panic，比如遇到证书错误会卡在 net::ERR_CERT_INVALID，chromedp.Navigate 直接返回错误。
实操建议：
- 全局忽略证书错误：在
chromedp.NewExecAllocator的选项里加chromedp.Flag("ignore-certificate-errors", "true") - 拦截并自动关闭 alert：用
chromedp.ActionFunc注册事件监听器，捕获page.EventJavascriptDialogOpening并调用page.HandleJavaScriptDialog(true).Do(ctx) - 防止无限重定向：用
chromedp.Navigate前设置page.SetLifecycleEventsEnabled(true).Do(ctx)，监听page.EventLifecycleEvent中的NetworkIdle状态，超时即断
截图和 PDF 导出内容不全？别只靠 time.Sleep
chromedp.CaptureScreenshot 或 chromedp.GeneratePDF 如果在页面滚动或动画结束后立即调用，常截到空白、半渲染或裁剪错位的内容。sleep 是反模式——本地快、CI 慢、不可靠。
实操建议：
- 等可视区域稳定：先
chromedp.ScrollIntoView(`#main-content`, chromedp.ByQuery)，再chromedp.Sleep(500 * time.Millisecond)（仅限简单动画），更推荐用chromedp.Evaluate(`document.querySelectorAll('.fade-in').length === 0`, &done) - Pdf 生成前确保页面无 pending 请求：
network.WaitForTargetIdle(2 * time.Second)（需启用network.Enable()） - 截图指定 viewport：
emulation.SetDeviceMetricsOverride(1920, 1080, 1, false).Do(ctx)，否则 headless 模式默认是 800x600
复杂点在于：DevTools 协议本身不暴露“JS 动画是否结束”或“React 组件是否 commit 完毕”，得靠业务侧提供可检测的全局标记（比如 window.__REACT_READY__ = true），否则只能折中用短 sleep + 多次轮询。这个边界，没人能替你定义。
