Selenium无法定位元素：控制台可查但代码报NoSuchElementException

以下是针对你遇到的问题的几种排查和解决方法：

1. 排查元素是否在iframe中 #

很多后台系统会用<iframe>嵌套表单模块，Selenium默认只会在主页面上下文查找元素，无法直接定位iframe内的元素。

• 打开浏览器F12开发者工具，选中目标元素，查看它的DOM结构是否被包裹在<iframe>标签内。
• 如果是，先切换到对应iframe再查找元素：

# 方式1：通过iframe的ID切换（替换成实际的iframe ID）
driver.switch_to.frame("customer_iframe")

# 方式2：通过XPATH定位iframe（根据实际页面调整）
iframe = driver.find_element(By.XPATH, "//iframe[contains(@src, 'customer_form')]")
driver.switch_to.frame(iframe)

# 切换后再定位目标元素
sel = driver.find_element(By.XPATH, "//*[@id='cmtx_pasaporte_i']")
sel.send_keys("198282828")

# 操作完成后，若需回到主页面上下文，执行：
driver.switch_to.default_content()

2. 添加显式等待，适配页面加载延迟 #

代码执行速度可能快于页面渲染，导致元素还未生成就触发查找操作。使用WebDriverWait显式等待元素出现：

from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# 等待10秒，直到元素被加载到DOM中
sel = WebDriverWait(driver, 10).until(
    EC.presence_of_element_located((By.XPATH, "//*[@id='cmtx_pasaporte_i']"))
)
sel.send_keys("198282828")

# 如果需要确保元素可交互（比如能输入），可改用：
# sel = WebDriverWait(driver, 10).until(
#     EC.element_to_be_clickable((By.XPATH, "//*[@id='cmtx_pasaporte_i']"))
# )

3. 确认是否在正确的窗口/标签页 #

如果从主页面跳转到客户页面时打开了新标签页，Driver可能仍停留在原窗口，需切换到新窗口：

# 获取所有打开的窗口句柄
window_handles = driver.window_handles
# 切换到最新打开的窗口（列表最后一个元素）
driver.switch_to.window(window_handles[-1])

# 之后再定位目标元素
sel = driver.find_element(By.XPATH, "//*[@id='cmtx_pasaporte_i']")
sel.send_keys("198282828")

4. 优化元素定位方式 #

如果元素是动态生成的，原有的XPATH可能不稳定，尝试结合更多属性或父级元素定位：

# 结合name属性和ID定位（替换成实际的name值）
sel = driver.find_element(By.XPATH, "//input[@name='pasaporte' and @id='cmtx_pasaporte_i']")

# 通过父级容器缩小范围（替换成实际的父级元素属性）
sel = driver.find_element(By.XPATH, "//div[@class='customer-info-section']//input[@id='cmtx_pasaporte_i']")

内容的提问来源于stack exchange，提问作者Paul Alexander Oh Escobar