Linux系统Selenium无头测试元素不可交互异常及键鼠操作失效求助

问题描述 #

在Linux系统中用Python做Selenium无头测试时，执行鼠标悬停、双击等Actions类操作，或是Keys.ENTER/Keys.TAB这类键盘操作时，会触发ELEMENT NOT INTERACTABLE EXCEPTION异常，所有键鼠交互完全失效。但同样的代码在Windows系统中，添加以下ChromeOptions参数后就能正常运行：

options = webdriver.ChromeOptions()
options.add_argument("--headless=new")      
options.add_argument("--window-size=1920,1080")
options.add_argument("--start-maximized")

解决方案 #

针对Linux环境，除了保留上述三个参数，还需要添加适配Linux系统的额外参数，确保无头模式下页面渲染和交互正常：

from selenium import webdriver

options = webdriver.ChromeOptions()
# 启用新版无头模式，行为更接近正常浏览器
options.add_argument("--headless=new")
# 设置窗口尺寸，保证目标元素处于可视区域
options.add_argument("--window-size=1920,1080")
# 最大化窗口，避免元素因窗口过小被隐藏
options.add_argument("--start-maximized")
# 禁用沙箱模式，解决Linux下权限限制导致的交互失败
options.add_argument("--no-sandbox")
# 禁用/dev/shm使用，规避Linux共享内存不足引发的渲染异常
options.add_argument("--disable-dev-shm-usage")
# 设置常规用户代理，避免网站拦截无头模式请求
options.add_argument("user-agent=Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36")

driver = webdriver.Chrome(options=options)

关键参数说明 #

• --no-sandbox：Linux中Chrome默认沙箱会限制无头模式的交互权限，禁用后可消除这类障碍。
• --disable-dev-shm-usage：部分Linux环境的/dev/shm分区容量有限，会导致Chrome页面渲染异常，进而影响元素交互。
• 自定义user-agent：部分网站会识别无头模式的默认UA并限制功能，设置常规UA可避免被拦截，确保元素正常加载。

内容的提问来源于stack exchange，提问作者Mohan Babu Sathish