Selenium Python：隐藏密码输入框无法交互问题排查

我正在修改zap auth仓库的Selenium Python代码，目标是通过一个包含隐藏密码输入框的登录页面，流程为：输入邮箱>点击“Continue”按钮>（密码框显示）输入密码>点击“Login”按钮，所有操作在同一页面完成，两个按钮ID不同。

尝试过ActionChains、find_element和execute_script填充字段，均未解决问题。相关代码片段：

if self.config.auth_password:
            try:
                # ActionChains(self.driver).click("Continue").perform()
                self.fill_password()
            except Exception:
                logging.warning(
                    'Did not find the password field - clicking Next button and trying again')
                button = self.driver.find_element_by_id("Continue")
                button.click()
                # if the password field was not found, we probably need to submit to go to the password page
                # login flow: username -> next -> password -> submit
                self.fill_password()

代码始终返回错误：selenium.common.exceptions.ElementNotInteractableException: Message: element not interactable，看起来之前的按钮点击操作被忽略。完整报错信息：

2022-12-16 18:42:21,099 Found element password by name
Traceback (most recent call last):
  File "/zap/zap_auth.py", line 203, in login
    self.fill_password()
  File "/zap/zap_auth.py", line 262, in fill_password
    return self.find_and_fill_element(self.config.auth_password,
  File "/zap/zap_auth.py", line 280, in find_and_fill_element
    element.clear()
  File "/usr/local/lib/python3.9/dist-packages/selenium/webdriver/remote/webelement.py", line 95, in clear
    self._execute(Command.CLEAR_ELEMENT)
  File "/usr/local/lib/python3.9/dist-packages/selenium/webdriver/remote/webelement.py", line 633, in _execute
    return self._parent.execute(command, params)
  File "/usr/local/lib/python3.9/dist-packages/selenium/webdriver/remote/webdriver.py", line 321, in execute
    self.error_handler.check_response(response)
  File "/usr/local/lib/python3.9/dist-packages/selenium/webdriver/remote/errorhandler.py", line 242, in check_response
    raise exception_class(message, screen, stacktrace)
selenium.common.exceptions.ElementNotInteractableException: Message: element not interactable
  (Session info: headless chrome=108.0.5359.98)

注：涉及私有网站无法提供网址，点击Continue按钮前密码框处于隐藏状态，点击后密码框显示，按钮ID变为login。登录流程处理的源码来自zap2docker-auth-weekly仓库的zap_auth.py文件。

解决方案 #

1. 显式等待密码框可交互 #

核心问题是点击Continue按钮后，密码框需要时间从隐藏状态切换为可交互状态，直接调用填充方法会操作不可见元素。需添加显式等待逻辑：

from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# 替换原有登录流程代码
if self.config.auth_password:
    try:
        # 先检查密码框是否已可交互
        WebDriverWait(self.driver, 10).until(
            EC.element_to_be_clickable((By.NAME, "password"))  # 替换为密码框实际定位符
        )
        self.fill_password()
    except Exception:
        logging.warning('Did not find the password field - clicking Next button and trying again')
        # 等待Continue按钮可点击后再点击
        continue_btn = WebDriverWait(self.driver, 10).until(
            EC.element_to_be_clickable((By.ID, "Continue"))
        )
        continue_btn.click()
        # 等待密码框变为可交互
        WebDriverWait(self.driver, 10).until(
            EC.element_to_be_clickable((By.NAME, "password"))
        )
        self.fill_password()

2. 优化fill_password的元素查找逻辑 #

报错发生在element.clear()，说明find_and_fill_element方法找到的元素虽存在但不可交互。修改该方法，加入显式等待：

def find_and_fill_element(self, value, element_id=None, element_name=None):
    if element_name:
        element = WebDriverWait(self.driver, 10).until(
            EC.element_to_be_clickable((By.NAME, element_name))
        )
    elif element_id:
        element = WebDriverWait(self.driver, 10).until(
            EC.element_to_be_clickable((By.ID, element_id))
        )
    else:
        raise ValueError("Either element_id or element_name must be provided")
    
    element.clear()
    element.send_keys(value)
    return element

3. 优化无头Chrome配置 #

无头模式下可能因视口大小、渲染问题导致元素不可交互，添加以下启动参数：

options = webdriver.ChromeOptions()
options.add_argument('--headless')
options.add_argument('--disable-gpu')
options.add_argument('--window-size=1920x1080')  # 设置标准窗口大小
options.add_argument('--no-sandbox')
driver = webdriver.Chrome(options=options)

4. 强制激活密码框（备选方案） #

如果等待逻辑无效，可通过JS强制显示并激活密码框：

# 在点击Continue按钮后执行
password_field = self.driver.find_element(By.NAME, "password")
# 强制显示并移除禁用属性
self.driver.execute_script("arguments[0].style.display = 'block'; arguments[0].removeAttribute('disabled');", password_field)
# 填充密码
password_field.clear()
password_field.send_keys(self.config.auth_password)

内容的提问来源于stack exchange，提问作者Dhody Rahmad Hidayat