Selenium Chrome无头模式首次运行超时，为何运行有头模式后恢复正常？

DevOps 小满

2026-6-13

问题描述

我用Flask搭建了本地Web服务器，通过Python结合Selenium Chrome无头模式执行自动化任务。但首次运行无头模式脚本时，连接Flask服务器会超时，在页面加载或元素等待阶段出现超时错误。有意思的是，如果先运行同一脚本的有头模式（不加--headless参数），就能正常运行；而且运行过有头模式后，再执行无头模式脚本也能正常工作，就像首次有头模式执行解锁了无头模式的功能一样。

环境信息

Selenium版本：4.28.1
Python版本：3.10.11
导入的模块：

from selenium import webdriver
from selenium.webdriver.support.ui import Select
from selenium.webdriver.common.alert import Alert
from selenium.webdriver.common.keys import Keys
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.common.action_chains import ActionChains
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By
from selenium.webdriver.remote.webelement import WebElement
from selenium.common.exceptions import NoAlertPresentException
from selenium.webdriver.chrome.options import Options
from fake_useragent import UserAgent

Chrome驱动配置：

op = webdriver.ChromeOptions()
op.add_argument("start-fullscreen")
op.add_argument("window-size=1920x1080")
op.add_argument('headless=new')

疑问

为什么无头模式首次运行失败，运行有头模式一次后就能正常工作？
这个现象和Chrome缓存、用户数据目录或网络行为有关吗？
怎么确保无头模式从首次运行起就能可靠工作？

解答

1. 首次无头模式失败的原因

Chrome的有头模式和无头模式默认使用不同的用户数据目录。首次启动无头模式时，Chrome处于全新的干净状态，没有任何缓存、Cookie或已保存的网络配置；而有头模式会加载系统默认的用户配置，包括可能已经建立的本地服务器连接缓存、信任的本地站点设置，甚至浏览器内部的网络优化状态。当你第一次运行有头模式后，相关的本地连接信息、缓存或者浏览器的网络状态被初始化，后续无头模式如果复用了部分配置（或者系统层面的网络缓存被激活），就能正常连接了。

另外，Chrome无头模式的网络栈初始化可能比有头模式更严格，首次启动时可能需要额外时间完成DNS解析、建立本地TCP连接，而你的Flask服务器或脚本的等待逻辑没给足初始化时间，导致超时；但有头模式运行后，系统的DNS缓存、TCP连接池已经有了记录，后续无头模式就能快速建立连接。

2. 和缓存、用户数据目录的关联

完全相关：

用户数据目录：有头模式默认使用系统默认的用户数据目录（比如Windows的AppData\Local\Google\Chrome\User Data），而无头模式默认会创建一个临时的、干净的用户数据目录。当你运行有头模式后，系统层面的网络缓存（比如DNS缓存）已被填充，或者如果脚本在有头模式下保存了本地站点的Cookie/缓存，后续无头模式如果意外复用这些（或系统缓存生效），就能正常访问。
缓存：首次无头模式没有任何缓存，加载本地页面时可能需要重新加载所有资源，而有头模式运行后，浏览器或系统的缓存已经有了这些资源的副本，后续无头模式加载更快，不会超时。
网络行为：Chrome的无头模式在首次启动时，网络请求的处理逻辑可能和有头模式有差异，比如没有预加载的网络连接池，而有头模式运行后，系统的TCP连接池已经存在活跃的本地连接，后续无头模式可以直接复用。

3. 确保无头模式首次运行正常的方案

方案一：指定无头模式使用固定的用户数据目录

让无头模式和有头模式使用同一个用户数据目录，这样首次启动就能加载已有的配置（如果没有，第一次运行也会初始化）：

op = webdriver.ChromeOptions()
op.add_argument("start-fullscreen")
op.add_argument("window-size=1920x1080")
op.add_argument('headless=new')
# 指定用户数据目录，替换成你Chrome的实际用户数据路径
op.add_argument(r'--user-data-dir=C:\Users\你的用户名\AppData\Local\Google\Chrome\User Data')
# 可选：指定单独的配置文件，避免影响主浏览器
op.add_argument('--profile-directory=AutomationProfile')

注意：如果主浏览器正在运行，指定同一个用户数据目录可能会冲突，建议创建专门的自动化配置文件目录。

方案二：优化等待逻辑，给足初始化时间

调整WebDriverWait的超时时间，或者在启动浏览器后先等待一段时间再访问本地服务器：

driver = webdriver.Chrome(options=op)
# 等待浏览器完全初始化
driver.implicitly_wait(10)
# 或者显式等待本地服务器可访问
WebDriverWait(driver, 15).until(
    EC.presence_of_element_located((By.TAG_NAME, "html"))
)

同时，确保Flask服务器在脚本运行前已完全启动，可以在脚本中添加检查Flask服务是否就绪的逻辑，比如用requests库先发送请求确认服务可用，再启动浏览器。

方案三：添加必要的无头模式参数，模拟有头环境

无头模式默认的部分参数和有头模式不同，添加以下参数让它更接近有头模式的行为：

op = webdriver.ChromeOptions()
op.add_argument("start-fullscreen")
op.add_argument("window-size=1920x1080")
op.add_argument('headless=new')
# 添加模拟有头模式的参数
op.add_argument("--no-sandbox")
op.add_argument("--disable-dev-shm-usage")
op.add_argument("--disable-gpu")
op.add_argument("--enable-javascript")
# 设置User-Agent，避免被识别为无头模式（本地服务器可能不需要，但可加上）
ua = UserAgent()
op.add_argument(f'user-agent={ua.chrome}')

这些参数可以减少无头模式和有头模式的环境差异，避免因环境不同导致的网络或加载问题。

方案四：预加载必要的缓存或配置

如果本地Web应用需要特定的Cookie或缓存，可以在首次运行无头模式前提前初始化这些内容，比如手动访问一次本地服务器保存缓存，或者在脚本中添加初始化逻辑。

内容的提问来源于stack exchange，提问作者Henry Chiles

Selenium Chrome无头模式首次运行超时，为何运行有头模式后恢复正常？

环境信息 #

疑问 #

1. 首次无头模式失败的原因 #

2. 和缓存、用户数据目录的关联 #

3. 确保无头模式首次运行正常的方案 #