使用Selenium下载内嵌窗口内文件时无法交互点击元素的问题

问题场景 #

需要下载JNE公开政党登记平台的公开附件：点击页面内的政党条目（例：第一个条目ACCION POPULAR）后，页面弹出内嵌模态窗口，原有Selenium代码无法和窗口内的文件元素交互，尝试所有可匹配的XPath路径都无法触发文件点击，原有失效代码如下：

for i in range(1,7):
    file_path = '//*[@id="MiVentanaContenido"]/div[2]/table/tbody/tr[1]/td'
    file = driver.find_element(By.XPATH, file_path)
    print(file.text)
    file.click()

失效原因 #

• 模态弹窗存在动态加载延迟，代码执行时弹窗内的文件元素还未渲染到DOM树，直接查找会返回元素不存在异常；部分场景下弹窗内容嵌套在独立iframe中，Selenium默认停留在主页面上下文，无法识别iframe内的元素
• 循环逻辑存在硬编码问题：循环变量i没有传入XPath表达式，路径固定写死tr[1]，哪怕元素定位成功，也只会反复点击第一行内容，无法遍历6个不同的文件
• 元素定位粒度错误：可点击的下载事件绑定在单元格内的<a>标签上，直接点击外层<td>标签不会触发下载逻辑

修复代码 #

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By
import time

# 提前配置浏览器自动下载，避免弹出保存确认框
chrome_opts = Options()
download_config = {
    "download.default_directory": "./jne_downloads", # 替换为本地实际下载路径
    "download.prompt_for_download": False,
    "download.directory_upgrade": True,
    "safebrowsing.enabled": True
}
chrome_opts.add_experimental_option("prefs", download_config)
driver = webdriver.Chrome(options=chrome_opts)
driver.get("https://aplicaciones007.jne.gob.pe/srop_publico/Consulta/PadronAfiliado#")

# 点击ACCION POPULAR条目触发弹窗
acc_pop_entry = WebDriverWait(driver, 15).until(
    EC.element_to_be_clickable((By.XPATH, "//td[contains(text(),'ACCION POPULAR')]"))
)
acc_pop_entry.click()

# 检测弹窗是否嵌套iframe，存在则切换上下文
try:
    popup_iframe = WebDriverWait(driver, 5).until(
        EC.presence_of_element_located((By.XPATH, "//div[@id='MiVentana']//iframe"))
    )
    driver.switch_to.frame(popup_iframe)
except:
    pass

# 等待文件列表加载完成
WebDriverWait(driver, 10).until(
    EC.presence_of_all_elements_located((By.XPATH, '//*[@id="MiVentanaContenido"]/div[2]/table/tbody/tr'))
)

# 遍历点击6个下载文件
for row_idx in range(1, 7):
    file_link_xpath = f'//*[@id="MiVentanaContenido"]/div[2]/table/tbody/tr[{row_idx}]/td//a'
    download_link = WebDriverWait(driver, 10).until(
        EC.element_to_be_clickable((By.XPATH, file_link_xpath))
    )
    print(f"触发第{row_idx}个文件下载：{download_link.text.strip()}")
    download_link.click()
    time.sleep(1.5) # 加间隔避免请求频率过高被拦截

# 操作完成切回主页面上下文
driver.switch_to.default_content()

排查提示 #

• 全程使用显式等待WebDriverWait替代固定时长的time.sleep()，既可以避免元素未加载导致的定位失败，也能提升脚本运行效率
• 如果元素始终定位失败，打开浏览器开发者工具的Elements面板，检查目标元素是否被包裹在iframe、shadow DOM内部，必须切换到对应DOM上下文后Selenium才能正常识别元素
• 若网站存在反爬校验，可在启动配置中添加user-agent、禁用自动化标识绕过基础检测

内容的提问来源于stack exchange，提问作者Nuri Taş