selenium截图需先启动无头chrome并确保页面加载完成：添加--headless=new和--no-sandbox参数，用webdriverwait等待元素就绪；全页截图应设大窗口尺寸或调用cdp的page.capturescreenshot；保存路径需utf-8编码、检查权限与目录存在性；空图多因gpu、iframe或canvas未就绪，需禁用gpu并验证渲染。
用 Selenium + ChromeDriver 截图前必须启动无头浏览器
直接调用 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 渲染出来了。
