Python Selenium无法定位模态div内download按钮实现PDF下载

定位失败Unable to locate element: [id="download"]的本质是存在两类定位障碍，而非下载按钮本身不存在：

• 点击触发按钮后弹出的浏览器原生打印对话框属于系统级UI元素，完全独立于网页DOM树结构，Selenium默认的DOM检索能力无法识别这类元素，哪怕页面上真的存在id为download的按钮，只要原生打印窗处于激活状态，所有DOM层面的元素定位都会被阻断
• 配套弹出的模态div弹窗可能存在动态加载延迟、iframe嵌套、顶层遮罩遮挡的问题，固定等待时间下的盲定位很容易触发时机不匹配的报错

方案1：绕过原生打印弹窗，通过浏览器CDP配置自动导出PDF（推荐） #

该方案完全不需要操作页面上的下载按钮、也不需要处理原生打印弹窗，从浏览器配置层面直接把打印请求自动输出为本地PDF，从根源上规避定位失败的问题：

• 初始化Chrome驱动时添加对应打印配置，关闭打印预览交互：

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

chrome_options = Options()
# 配置PDF自动导出参数
chrome_options.add_experimental_option("prefs", {
    # 固定打印目标为“保存为PDF”
    "printing.print_preview_sticky_settings.appState": '{"recentDestinations":[{"id":"Save as PDF","origin":"local","account":""}],"selectedDestinationId":"Save as PDF","version":2}',
    "printing.print_preview_sticky_settings.appState.isGcpPromoAcknowledged": True,
    # 配置PDF本地存储路径
    "savefile.default_directory": "/替换为你的PDF存储绝对路径",
    "download.default_directory": "/替换为你的PDF存储绝对路径",
    "download.prompt_for_download": False
})
# 启用无交互打印模式，弹出打印请求时直接自动执行导出
chrome_options.add_argument("--kiosk-printing")
driver = webdriver.Chrome(options=chrome_options)

• 调整脚本执行流程：访问目标页面→点击触发打印的按钮，浏览器会自动跳过所有弹窗交互，直接把打印内容按指定路径保存为PDF文件，无需要求定位页面上的download按钮。

方案2：页面模态弹窗内下载按钮的定位优化（仅适用于无原生打印弹窗遮挡的场景） #

如果验证确认原生打印弹窗未激活、仅模态div存在时定位失败，按以下逻辑调整定位逻辑：

• 替换固定sleep为显式等待，等元素完全可交互后再执行点击，避免加载延迟导致的定位报错：

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

# 最长等待10秒，直到下载按钮可被点击
wait = WebDriverWait(driver, 10)
download_btn = wait.until(EC.element_to_be_clickable((By.ID, "download")))
download_btn.click()

• 排查元素上下文：如果下载按钮嵌套在iframe内，需先通过driver.switch_to.frame(对应iframe定位)切换上下文后再定位；如果元素被遮罩层遮挡，可通过JS脚本移除顶层遮挡元素后再执行点击。

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