使用Selenium访问iframe时#document不显示，手动操作正常该如何解决？

问题原因 #

• 自动化特征被检测：HiPay支付网关的托管字段会检测Selenium的自动化标识（如navigator.webdriver为true等），检测到自动化操作时会主动阻止iframe内部内容加载，这是核心问题的核心原因。
• 操作时机错误：刷新页面后没有等待iframe加载完成就执行元素查找或iframe切换操作，导致操作全部无效。
• 刷新方法不规范：通过sendKeys(Keys.F5)的方式刷新页面不可靠，且刷新后未重置页面上下文，原有元素引用全部失效。
• iframe定位方式错误：你使用的iframe id带有动态生成的instanceId后缀，用固定id定位会失效，未使用固定属性定位iframe。
• 窗口视口问题：如果开启无头模式或窗口尺寸过小，HiPay的托管字段会判定为异常环境，不加载内部内容。

解决方法 #

1. 配置Chrome启动参数，屏蔽自动化检测标识 #

ChromeOptions options = new ChromeOptions();
// 屏蔽自动化检测
options.addArguments("--disable-blink-features=AutomationControlled");
options.setExperimentalOption("excludeSwitches", new String[]{"enable-automation"});
options.setExperimentalOption("useAutomationExtension", false);
// 设置足够大的窗口尺寸
options.addArguments("window-size=1920,1080");
WebDriver driver = new ChromeDriver(options);
JavascriptExecutor js = (JavascriptExecutor) driver;
// 额外覆盖webdriver属性
js.executeScript("Object.defineProperty(navigator, 'webdriver', {get: () => undefined})");

2. 调整操作流程，增加显式等待 #

// 点击跳转支付按钮
WebElement ClkPaiementByCard = new WebDriverWait(driver, 10).until(ExpectedConditions.elementToBeClickable(By.id("payed-cart")));
js.executeScript("arguments[0].click();", ClkPaiementByCard);

// 执行标准页面刷新
driver.navigate().refresh();

// 等待iframe加载完成并自动切换上下文
new WebDriverWait(driver, 15).until(ExpectedConditions.frameToBeAvailableAndSwitchToIt(By.cssSelector("iframe[data-hipay-id='hostedfield-iframe']")));

// 等待iframe内部卡号输入框加载完成再操作
WebElement CardNumber = new WebDriverWait(driver, 10).until(ExpectedConditions.visibilityOfElementLocated(By.xpath("//div[@id=\"root\"]/div/div/form/div/div/input[@name=\"cardnumber\"]")));
CardNumber.clear();
CardNumber.sendKeys("4111 1111 1111 1111");

WebElement ExpDate = new WebDriverWait(driver, 10).until(ExpectedConditions.visibilityOfElementLocated(By.xpath("//div[@id=\"root\"]/div/div/input[@name=\"cc-exp\"]")));
ExpDate.clear();
ExpDate.sendKeys("05/24");

WebElement CVC = new WebDriverWait(driver, 10).until(ExpectedConditions.visibilityOfElementLocated(By.xpath("//div[@id=\"root\"]/div/div/input[@name=\"cvc\"]")));
CVC.clear();
CVC.sendKeys("123");            

// 提交按钮在主页面时，必须先切回主上下文
driver.switchTo().defaultContent();
WebElement SubmitPaiement = new WebDriverWait(driver, 10).until(ExpectedConditions.elementToBeClickable(By.id("submit-button")));
js.executeScript("arguments[0].click();", SubmitPaiement);

额外注意事项 #

• 如果使用无头模式，需要额外添加options.addArguments("--headless=new")参数，新版Chrome无头模式的指纹和普通模式更接近，不容易被检测。
• 所有iframe内操作完成后，只要需要操作主页面元素，都必须执行driver.switchTo().defaultContent()切回主上下文。

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