如何使用Python Selenium实现自动化的长截屏和网页快照？-Python教程-PHP中文网

screenshot()截不满整页，因其仅捕获当前视口内容，不触发滚动或合成，对超长页面（如>10000px）仅得顶部一屏、底部全黑；须手动滚动+分段截图+pil拼接，并等待js动态内容就绪才能实现完整dom渲染快照。

如何使用python selenium实现自动化的长截屏和网页快照？

长截屏不能只靠 screenshot()，必须滚动+拼接；网页快照若需完整 DOM 渲染（含懒加载、JS 交互后状态），得等元素就绪再截。

为什么 `screenshot()` 截不满整页？

ChromeDriver 默认只截当前视口（viewport）内容，即使页面有滚动条，screenshot() 也不会自动滚到底部再拼——它压根不滚动。遇到高度超 10000px 的管理后台或文档页，直接截出白底+顶部内容，底部全黑或空白。

真实表现：调用 driver.get("https://example.com"); driver.save_screenshot("a.png") 后打开图片，发现只有一屏
根本原因：底层是 DevTools Protocol 的 Screenshot.captureScreenshot，不带滚动逻辑
兼容性注意：Firefox 的 get_full_page_screenshot_as_png() 声称支持全页，但实际对 position: fixed 元素、iframe 内容、阴影/滤镜渲染常失效

手动滚动拼接长图的可靠做法

核心思路是分段滚动 → 截图 → 计算偏移 → 合成 PNG。别依赖第三方库（如 pyautogui 或过时的 selenium-screenshot），自己控制更稳。

先用 driver.execute_script("return document.body.scrollHeight") 获取总高度
用 driver.execute_script("window.scrollTo(0, arguments[0])", y) 精确滚动到目标 Y 坐标（避免 scrollIntoView 被 sticky header 干扰）
每次滚动后 time.sleep(0.3) 等渲染（尤其含动画/图表的页面），必要时加 WebDriverWait(driver, 3).until(EC.presence_of_element_located((By.TAG_NAME, "footer")))
截图存为 PIL.Image 对象，用 Image.new("RGB", (width, total_height)) 创建画布，逐张 paste()，Y 偏移 = 当前滚动位置

示例关键片段：

python 查询技能

查询客流数据，输出JSON格式，可直接导入Bitable等可视化工具

下载

height = driver.execute_script("return document.body.scrollHeight")
width = driver.execute_script("return window.innerWidth")
chunks = []
for y in range(0, height, 1080):  # 每次滚 1080px（常见屏高）
    driver.execute_script(f"window.scrollTo(0, {y})")
    time.sleep(0.3)
    chunks.append(Image.open(io.BytesIO(driver.get_screenshot_as_png())))
# 合成逻辑略（需对齐 width，处理最后一块裁剪）

网页快照要「所见即所得」，必须等 JS 动态内容就绪

所谓“快照”不是静态 HTML 抓取，而是浏览器渲染完成后的像素快照。如果页面用 React/Vue 加载表格、用 IntersectionObserver 触发图片懒加载，get_screenshot_as_png() 可能截到空容器或占位图。

不要只等 document.readyState == "complete"，它不保证 Vue mounted 或 React useEffect 执行完
优先等关键元素出现：WebDriverWait(driver, 10).until(EC.visibility_of_element_located((By.ID, "data-table")))
对图表类页面（ECharts / Chart.js），加一句 driver.execute_script("return typeof echarts !== 'undefined' && echarts.getInstanceById('chart')?.isFinished()")
极端情况可兜底：driver.execute_script("return performance.getEntriesByType('navigation')[0].loadEventEnd > 0") 确保 load 事件已触发