为何使用Python+Selenium无法通过ID/XPath点击指定按钮？

我在自动化报表生成流程时，打开新标签页后无法点击「Add Custom Report」按钮，此前所有代码步骤都正常执行。网站、用户名和密码均为虚构。我已经尝试通过ID和XPath定位该按钮，但都无法触发点击操作。

我的代码： #

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

usernameStr = 'randomemail@whocares.com'
passwordStr = 'hunter2(jokepassword)'
report = 'Experiment'

browser = webdriver.Chrome()
browser.get('www.fakeurlIjustmadeup.com')

username = browser.find_element(By.CSS_SELECTOR, '.gb-login-form .gb-user-input input')
username.send_keys(usernameStr)

password = WebDriverWait(browser, 10).until(EC.presence_of_element_located((By.CSS_SELECTOR, '.gb-login-form .gb-user-pwd input')))
password.send_keys(passwordStr)

loginButton = browser.find_element(By.CSS_SELECTOR, '.gb-login-form .gb-login-button button')
loginButton.click()

reportsTab = browser.find_element(By.CSS_SELECTOR, '#reports')
reportsTab.click()

reportsButton = WebDriverWait(browser, 10).until(EC.element_to_be_clickable((By.ID, 'SearchReports')))
reportsButton.click()

browser.switch_to.window(browser.window_handles[-1])

# Custom Report Not Working with ID
# customButton = WebDriverWait(browser, 10).until(EC.element_to_be_clickable((By.ID, "AddCustomReport")))
# customButton.click()

# Custom Report Not Working with xpath
# customButton = browser.find_element(By.XPATH, '//*[@id="AddCustomReport"]')
# customButton.click()

time.sleep(10)

页面HTML结构： #

<!DOCTYPE html>
<html lang="en">
<input id="CustomReportsViewModel" name="CustomReportsViewModel" type="hidden" value='{"IsCustomReportLibrary":true,"SchoolId":1,"YearId":11,"IsTeacher":false,"MqAddEditVM":null,"ModuleQueryInfoList":[{"QueryID":1083,"QueryNumber":0,"QueryName":"Experiment","SchoolId":0,"YearID":0,"CreatdDate":"\/Date(-62135596800000)\/","QueryOnType":"Scores","CreatorType":null,"CreatorId":null,"IsExtraQueryType":false,"IsIncludeWithDrawn":false,"IsQueryEnabled":false,"IsDefaultQuery":false,"IsAbsScoreType":false}],"CourseFields":null,"SectionFields":null,"MQAvilableFieldsCol":null}'>
<input name="__RequestVerificationToken" type="hidden" value="305gVOidQElbfPBJ0-6t5tg3XYbLZwDnZciZYpr0PaXwroXTFjRqLUXHr1XC8W9eSO8ISMYqGFycTseQILfNPTQ7IMFETzXY-pf4CXj_n1A1">
<div class="border-bottom wrapper white-bg page-heading m-b">
    <div class="col-md-8">
        <h2>Reports Library</h2>
    </div>
</div>

<div id="MainGridReports">

    <div class="page-wrapper">
        <div class="col-md-12 bottom-space-fix">
            <div class="ibox float-e-margins ibox-title no-padding">
                <div class="form-horizontal">
                    <div class="btn-row">
                        <button type="button" class="btn btn-primary pull-right" id="AddCustomReport">Add Custom Report</button>
                            
                    <div class="ibox-content">
                        <h3>Default Reports</h3>
                        <div id="gridDefaultReport" data-role="tooltip" class="k-grid k-widget k-display-block" style=""><div>
<style>
    *[role="row"] {
      height: 34px !important;
    }
</style>
</body>
</html>

解决方法尝试 #

1. 确保元素完全可见且可交互 #

切换到新标签页后，优先等待元素可见而非仅可点击，避免元素已加载但未渲染完成的情况：

customButton = WebDriverWait(browser, 15).until(EC.visibility_of_element_located((By.ID, "AddCustomReport")))
customButton.click()

2. 使用JavaScript强制点击 #

如果常规点击失效，直接通过JavaScript触发按钮的点击事件，绕过元素的交互状态限制：

customButton = WebDriverWait(browser, 10).until(EC.presence_of_element_located((By.ID, "AddCustomReport")))
browser.execute_script("arguments[0].click();", customButton)

3. 检查是否存在iframe嵌套 #

虽然当前HTML未显示，但按钮可能被嵌套在iframe中，需要先切换到iframe再定位：

# 定位并切换到iframe（根据实际情况调整定位方式）
iframe = WebDriverWait(browser, 10).until(EC.presence_of_element_located((By.TAG_NAME, "iframe")))
browser.switch_to.frame(iframe)

# 定位并点击按钮
customButton = WebDriverWait(browser, 10).until(EC.element_to_be_clickable((By.ID, "AddCustomReport")))
customButton.click()

# 操作完成后切回主文档
browser.switch_to.default_content()

4. 等待页面遮罩层消失 #

页面可能存在加载遮罩层遮挡按钮，需先等待遮罩层隐藏：

# 假设遮罩层的CSS选择器为.loading-mask（根据实际页面调整）
WebDriverWait(browser, 10).until(EC.invisibility_of_element_located((By.CSS_SELECTOR, ".loading-mask")))

customButton = WebDriverWait(browser, 10).until(EC.element_to_be_clickable((By.ID, "AddCustomReport")))
customButton.click()

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