C产品如何满足特定用户需求？

本文共计984个文字，预计阅读时间需要4分钟。

使用`IWebDriver.GetScreenshot()`直接调用会失败，除非浏览器已真实启动并加载完页面。Selenium默认启动的是有界面的Chrome，但在服务器或CI环境中没有图形界面，必须以无头模式启动。否则，进程会卡住或报`ChromeDriver failed to start`错误。

实操建议：

• 初始化 ChromeOptions 时务必添加 --headless=new（新版推荐，兼容 Chrome 112+；旧版 --headless 已弃用）和 --no-sandbox（Linux/容器环境必需）
• Windows 下可省略 --no-sandbox，但加上更稳妥
• 若截图内容为空白白屏，大概率是页面未等待加载完成就截图，需配合 WebDriverWait 等待关键元素或 DOM 就绪

截图尺寸不全？用 SetWindowRect 固定视口再截全页

默认 driver.GetScreenshot() 只截当前视口（viewport），滚动后的内容不会包含。要截完整页面（含滚动区域），不能只靠拉伸窗口——Chrome 的无头模式对 maximize 支持不稳定，应手动设置足够大的窗口尺寸，并启用全页截图能力。

实操建议：

• 调用 driver.Manage().Window.SetWindowSize(width, height) 前，先用 driver.Manage().Window.Maximize() 触发一次布局，再设具体值（如 1920x10800）
• 更可靠的方式是用 ChromeOptions 添加 --window-size=1920,10800 启动参数，避免运行时 resize 失效
• 全页截图需依赖 Chrome DevTools Protocol（CDP），Selenium 4+ 支持：var devTools = driver as IDevTools; ... devTools.GetDevToolsSession().SendCommandAsync("Page.captureScreenshot", new Dictionary<string object> { ["format"] = "png", ["captureBeyondViewport"] = true });</string>

保存截图文件时中文路径乱码或权限拒绝

Screenshot.SaveAsFile() 底层调用 .NET 的 FileStream，若传入含中文的路径且未指定编码或权限，可能抛出 UnauthorizedAccessException 或生成乱码文件名。尤其在 Windows 服务、IIS 或 Docker 容器中常见。

实操建议：

• 路径统一用 Path.Combine() 拼接，避免硬写 "\" 或 "/"
• 保存前检查目录是否存在：Directory.CreateDirectory(Path.GetDirectoryName(filePath))
• 文件名避开中文，用 DateTime.Now.ToString("yyyyMMdd_HHmmss") + GUID 生成安全名称
• 若必须中文名，确保项目编码为 UTF-8（Encoding.UTF8），并确认运行账户对目标目录有写权限（Linux 下注意 SELinux 或 mount 参数）

为什么 GetScreenshot() 返回空 PNG 或黑图？

常见于页面含 canvas、WebGL、iframe 跨域内容，或 Chrome 启动时未禁用 GPU 加速。Selenium 截图本质是 Chrome 的渲染快照，GPU 渲染路径在无头模式下可能被跳过或降级。

实操建议：

• 启动参数追加 --disable-gpu --force-device-scale-factor=1，消除缩放与 GPU 兼容性干扰
• 若页面含 iframe，确保主文档已完全加载（document.readyState === "complete"），再等 iframe 内容 onload
• Canvas 类内容需确认是否使用了 OffscreenCanvas 或 WebGL 上下文未激活——这类截图必然为空，只能改用前端主动导出 canvas.toDataURL()
• 调试时临时去掉 --headless，用有界面 Chrome 验证是否真能正常渲染

真正难处理的不是截图动作本身，而是让 Chrome 在各种环境里稳定渲染出你想要的那一帧——无头、GPU、跨域、动态资源加载，任何一个环节断掉，截图就不可信。别迷信“一键截图”，先确认页面真被 Chrome 渲染出来了。