PyCharm运行Chrome无头模式脚本正常 终端执行报错如何解决

解决方案 #

核心根因 #

报错本质是终端运行时Chrome启动参数、执行环境和PyCharm不一致，导致页面未正常渲染、目标元素不存在，触发前端JS报错。你可以按以下步骤逐一排查修复： #

1. 补充无头模式必备启动参数 #

无头Chrome默认配置和有头模式差异极大，很容易被网站识别拦截，或者因为视口过小导致响应式页面不渲染目标元素，在原有配置基础上追加以下参数：

options = Options()
options.add_argument('--headless')
options.add_argument('--disable-gpu')
# 追加以下参数
options.add_argument('--window-size=1920,1080') # 固定视口大小，避免小视口下元素不渲染
options.add_argument('--no-sandbox') # 禁用沙箱，终端/定时任务运行必备
options.add_argument('--disable-dev-shm-usage') # 解决共享内存不足导致的页面加载异常
options.add_argument('user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.107 Safari/537.36') # 手动设置UA，绕过无头模式检测
dr = webdriver.Chrome(ChromeDriverManager().install(), options=options)

2. 统一PyCharm和终端的Python执行环境 #

PyCharm默认使用项目配置的虚拟环境，终端默认调用全局Python，两个环境的依赖版本不一致也会导致运行结果不同：

• 先在PyCharm的终端执行where python（Windows）获取Python解释器的绝对路径，比如C:\project\venv\Scripts\python.exe
• 后续终端运行脚本、配置定时任务时，都用该绝对路径执行，避免调用错环境：

C:\project\venv\Scripts\python.exe C:\project\main.py

3. 优化等待逻辑，避免网络波动导致元素未加载完成 #

终端运行时网络环境可能和PyCharm测试时不同，延长显式等待时间，追加页面加载完成判断：

dr.get("url")
# 等待时间从5秒延长到15秒
cWait = WebDriverWait(dr, 15)
# 先等待页面完全加载完成再查找元素
cWait.until(lambda d: d.execute_script('return document.readyState') == 'complete')
usernameField = cWait.until(EC.presence_of_element_located((By.ID, "txtUserID")))

4. 调试验证页面加载状态 #

如果上述步骤都无效，可以临时注释掉--headless参数，在终端执行脚本，直观查看Chrome打开的页面是否和预期一致，有没有出现拦截、跳转、页面加载不全的情况，也可以在查找元素前加截图代码确认页面状态：

dr.save_screenshot("debug_page.png")

内容的提问来源于stack exchange，提问作者Shyam Sundar