根本原因是无头模式默认浏览器环境与真实浏览器差异大：User-Agent含headless字样、缺GPU加速、禁用图片/字体加载、时区和屏幕尺寸异常，导致依赖navigator.webdriver或媒体查询的前端框架跳过渲染，元素未挂载DOM。
为什么无头模式下 find_element 经常超时或返回空？
根本原因不是“无头模式不支持元素查找”，而是它默认的浏览器环境和真实浏览器差异太大：User-Agent 是 headless Chrome 字样、缺少 GPU 加速、默认禁用图片/字体加载、甚至时区和屏幕尺寸都异常。这些会让某些前端框架（比如依赖 window.matchMedia 或 navigator.webdriver 检测爬虫的 SPA）直接跳过渲染逻辑，导致元素压根没挂到 DOM 上。
实操建议：
- 必须显式设置
--user-agent，伪装成常规浏览器，例如"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" - 加
--disable-gpu和--no-sandbox是必须项，否则在 Docker 或 CI 环境里会直接启动失败 - 务必设置
--window-size=1920,1080，否则像 Ant Design 这类组件库可能因媒体查询判定为移动端而隐藏侧边栏等关键区域 - 禁用自动化特征：加上
--disable-blink-features=AutomationControlled，并运行 JS 删除navigator.webdriver
如何绕过前端对 navigator.webdriver 的检测？
很多网站（尤其是登录页或风控页）会在 JS 中检查 navigator.webdriver === true，一旦为真就拒绝渲染核心内容或触发验证码。Selenium 默认启用该标志，且仅靠参数无法关闭。
实操建议：
- 启动后立即执行 JS 注入，覆盖该属性：
driver.execute_cdp_cmd('Page.addScriptToEvaluateOnNewDocument', {'source': 'Object.defineProperty(navigator, "webdriver", {get: () => undefined})'}) - 不要用
driver.execute_script("navigator.webdriver = undefined")—— 这只能改当前页面，新打开的 tab 或 iframe 不生效 - 如果页面用了
Object.getOwnPropertyDescriptor检测 descriptor，还需补一层 getter 拦截（较罕见，但银行类站点可能出现）
WebDriverWait 等待失效？试试换等待条件
无头环境下，元素可能“存在 DOM”但不可见、不可点击，或者被动态插入后又被 JS 移除（如广告占位符闪现）。此时用 presence_of_element_located 容易误判成功。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
实操建议：
- 优先用
visibility_of_element_located或element_to_be_clickable，它们会校验 CSSdisplay、opacity和pointer-events - 对 React/Vue 应用，可配合自定义等待：检查
document.readyState === "complete"且window.__POWERED_BY_QIANKUN__（或类似全局变量）已定义 - 避免写死
time.sleep(3)—— 无头模式实际加载往往更快，但不稳定；反而让脚本变慢还掩盖真实问题
Docker 中运行无头 Selenium 总是卡住？检查这三点
本地能跑，一丢进 Docker 就卡在 driver.get() 或白屏，基本是环境缺失导致 Chromium 启动不完整。
实操建议：
- 基础镜像必须含字体库：
apt-get install -y fonts-liberation libxss1 libappindicator1 libasound2 - 确保使用
--shm-size=2g启动容器，否则 Chromium 渲染进程因共享内存不足直接崩溃（错误日志里会出现Failed to move to new namespace） - 若用
selenium/standalone-chrome镜像，别直接挂载 host 的/dev/shm—— Docker for Mac/Windows 不兼容，必须用--shm-size显式分配
真正麻烦的从来不是“怎么写定位语句”，而是无头环境把整个浏览器上下文悄悄改了。每加一个参数，都得想清楚它在绕过哪层检测、补全哪个缺失能力——否则只是在错误路径上反复重试。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
