1. 项目概述当自动化测试遇上“被控制”的烦恼如果你正在用Selenium做Edge浏览器的自动化测试尤其是基于最新的Chromium内核版本那么你很可能遇到过这个令人头疼的弹窗“Microsoft Edge正由自动测试软件控制”。这个提示不仅会中断你的测试流程在某些需要截图或录屏的场景下还会污染你的测试报告让自动化脚本显得“不专业”。更麻烦的是在一些持续集成CI环境或无头Headless模式下这个弹窗甚至可能导致脚本卡死或失败。我最近在搭建一套基于Selenium 4和最新版Edge的UI自动化测试流水线时就反复被这个问题困扰。无论是简单的页面打开还是复杂的表单操作这个提示就像个不请自来的“监工”时不时跳出来刷存在感。经过一番折腾和源码层面的探究我终于找到了一个稳定、一劳永逸的解决方案。这个方法不依赖于任何第三方插件或修改系统文件而是通过Selenium的EdgeOptions直接向浏览器启动参数注入特定的实验性标志experimental options从根源上屏蔽这个提示。下面我就把完整的思路、操作步骤和避坑经验分享给你。2. 核心问题解析为什么Edge会提示“被控制”在深入解决方案之前我们得先搞清楚这个提示从何而来。这其实是Chromium内核Edge、Chrome、新版Opera等浏览器的共同内核的一项安全与用户体验特性。2.1 提示的根源enable-automation开关当你使用Selenium WebDriver启动浏览器时WebDriver会在浏览器实例中设置一个特定的标志--enable-automation。这个标志的本意是好的它告诉浏览器“现在有一个自动化程序在控制我”。浏览器得知此信息后会做两件事禁用部分可能被恶意软件利用的弹窗或功能以提升自动化环境下的安全性。在浏览器顶部显示“正由自动测试软件控制”的提示栏这是为了提醒普通用户防止他们被伪装成正常浏览器的自动化脚本欺骗。所以这个提示是浏览器内核层面的行为是Chromium对--enable-automation标志的标准响应。我们的目标不是阻止WebDriver设置这个标志因为某些自动化特性需要它而是阻止浏览器显示那个烦人的提示栏。2.2 传统方法的局限性网上常见的解决方案是尝试在EdgeOptions或ChromeOptions中添加excludeSwitches来禁用enable-automation就像这样from selenium import webdriver from selenium.webdriver.edge.options import Options options Options() options.add_experimental_option(excludeSwitches, [enable-automation]) driver webdriver.Edge(optionsoptions)但实测下来对于较新版本的Chromium内核Edge例如版本115以上这个方法经常失效。浏览器依然会倔强地显示出提示。这是因为Chromium团队在不断调整安全策略单纯排除这个开关可能已经不足以覆盖提示触发的所有条件。3. 终极解决方案使用excludeSwitches结合useAutomationExtension经过对不同版本Edge和Chromium驱动程序的测试我发现一个组合拳策略非常有效。其核心思路是双管齐下通过excludeSwitches禁用自动化开关的某些副作用。通过另一个实验性选项useAutomationExtension直接禁止浏览器加载那个负责显示提示的“自动化扩展”。以下是经过验证的、适用于最新Chromium版Edge的代码实现。3.1 Python版本实现from selenium import webdriver from selenium.webdriver.edge.service import Service from selenium.webdriver.edge.options import Options def create_edge_driver_without_notification(): 创建不显示“被控制”提示的Edge WebDriver实例 # 1. 配置浏览器选项 edge_options Options() # 关键步骤1排除‘enable-automation’开关这是基础操作 edge_options.add_experimental_option(excludeSwitches, [enable-automation]) # 关键步骤2禁用自动化控制扩展这是屏蔽提示的核心 edge_options.add_experimental_option(useAutomationExtension, False) # 可选但推荐的步骤添加其他参数以优化自动化体验 # --disable-blink-featuresAutomationControlled 可进一步移除navigator.webdriver标志 edge_options.add_argument(--disable-blink-featuresAutomationControlled) # 无头模式运行适合CI环境 # edge_options.add_argument(--headlessnew) # 禁用沙箱在某些Docker或受限环境中可能需要 # edge_options.add_argument(--no-sandbox) # 禁用/dev/shm使用避免内存不足问题 # edge_options.add_argument(--disable-dev-shm-usage) # 2. 指定EdgeDriver路径如果未添加到系统PATH # service Service(executable_pathrC:\path\to\msedgedriver.exe) # driver webdriver.Edge(serviceservice, optionsedge_options) # 3. 创建驱动实例假设msedgedriver已在PATH中 driver webdriver.Edge(optionsedge_options) # 4. 额外执行一个CDP命令确保万无一失针对高级反检测场景 # 这可以移除更多自动化痕迹 driver.execute_cdp_cmd(Page.addScriptToEvaluateOnNewDocument, { source: Object.defineProperty(navigator, webdriver, { get: () undefined }); }) return driver # 使用示例 if __name__ __main__: driver create_edge_driver_without_notification() try: driver.get(https://www.bing.com) print(页面标题:, driver.title) # 此处可以安心地进行你的自动化操作不会有提示栏干扰 # 例如截图、元素操作等 driver.save_screenshot(screenshot_without_notice.png) finally: driver.quit()3.2 Java版本实现import org.openqa.selenium.WebDriver; import org.openqa.selenium.edge.EdgeDriver; import org.openqa.selenium.edge.EdgeOptions; public class EdgeDriverWithoutNotification { public static WebDriver createDriver() { // 1. 配置浏览器选项 EdgeOptions options new EdgeOptions(); // 关键步骤1排除‘enable-automation’开关 options.setExperimentalOption(excludeSwitches, new String[]{enable-automation}); // 关键步骤2禁用自动化控制扩展 options.setExperimentalOption(useAutomationExtension, false); // 可选添加其他优化参数 options.addArguments(--disable-blink-featuresAutomationControlled); // options.addArguments(--headlessnew); // 2. 创建驱动实例 WebDriver driver new EdgeDriver(options); // 3. 执行CDP命令移除navigator.webdriver属性可选 // 需要将driver强制转换为EdgeDriver或ChromiumDriver来使用executeCdpCommand if (driver instanceof EdgeDriver) { ((EdgeDriver) driver).executeCdpCommand(Page.addScriptToEvaluateOnNewDocument, Map.of(source, Object.defineProperty(navigator, webdriver, { get: () undefined }))); } return driver; } public static void main(String[] args) { WebDriver driver createDriver(); try { driver.get(https://www.bing.com); System.out.println(页面标题: driver.getTitle()); // 进行自动化测试... } finally { driver.quit(); } } }3.3 C#版本实现using OpenQA.Selenium; using OpenQA.Selenium.Edge; class Program { static IWebDriver CreateEdgeDriverWithoutNotification() { // 1. 配置浏览器选项 var edgeOptions new EdgeOptions(); // 关键步骤1排除‘enable-automation’开关 edgeOptions.AddExcludedArgument(enable-automation); // 注意Selenium WebDriver for .NET 中useAutomationExtension的设置方式可能不同 // 通常通过AddAdditionalOption或AddArgument实现 edgeOptions.AddAdditionalOption(useAutomationExtension, false); // 关键步骤2添加参数禁用自动化控制特征 edgeOptions.AddArgument(--disable-blink-featuresAutomationControlled); // edgeOptions.AddArgument(--headlessnew); // 2. 创建驱动实例 var driver new EdgeDriver(edgeOptions); // 3. 执行CDP命令需要将driver转换为EdgeDriver以访问ExecuteCdpCommand var edgeDriver driver as EdgeDriver; if (edgeDriver ! null) { edgeDriver.ExecuteCdpCommand(Page.addScriptToEvaluateOnNewDocument, new Dictionarystring, object { [source] Object.defineProperty(navigator, webdriver, { get: () undefined }) }); } return driver; } static void Main(string[] args) { var driver CreateEdgeDriverWithoutNotification(); try { driver.Navigate().GoToUrl(https://www.bing.com); Console.WriteLine($页面标题: {driver.Title}); // 进行自动化测试... } finally { driver.Quit(); } } }4. 方案原理解析与参数详解仅仅复制代码是不够的理解每个参数背后的意义才能在未来版本变化或遇到类似问题时举一反三。4.1excludeSwitches: [“enable-automation”]这个选项的作用是告诉浏览器驱动程序msedgedriver“请不要将--enable-automation这个命令行开关传递给实际的浏览器进程msedge.exe”。理论上没有这个开关浏览器就不会知道自己被自动化控制。但正如前文所述由于Chromium内部逻辑的复杂性仅靠这一步在新版本中可能不够。4.2useAutomationExtension: false这是屏蔽提示最关键的一步。当--enable-automation开关被设置后Chromium浏览器会默认加载一个名为“Chrome Automation Extension”的内部扩展。这个扩展正是那个黄色提示栏的“元凶”。将useAutomationExtension设置为False就是明确指示浏览器不要加载这个扩展从而从根本上阻止了提示的显示。实操心得在我测试的Edge 120版本上只设置excludeSwitches提示依然会出现。但加上useAutomationExtension: false后提示立刻消失。这个组合在目前看来是最可靠的。4.3--disable-blink-featuresAutomationControlled这是一个Chromium的命令行参数。Blink是Chromium的渲染引擎。AutomationControlled是一个被Blink引擎识别的特性标志。设置此参数可以进一步指示渲染引擎当前环境是受控的从而可能禁用一些仅针对真实用户的前端行为或检测。它主要影响的是JavaScript环境如navigator.webdriver属性但对视觉提示也有辅助抑制作用。4.4 通过CDP命令覆盖navigator.webdriverCDPChrome DevTools Protocol是Chrome/Edge开发者工具背后的协议WebDriver底层也在使用它。我们通过execute_cdp_cmd执行的这段JavaScript代码会在每个新页面加载之初就运行。它的作用是将navigator.webdriver这个属性重写使其返回undefined。很多网站会检测这个属性来判断是否处于自动化环境。虽然这与屏蔽视觉提示不直接相关但这是构建一个“隐形”自动化浏览器的重要一步让你的脚本更难被前端检测到。5. 环境准备与依赖检查在应用上述代码前请确保你的测试环境已经正确配置。很多问题都源于环境的不一致。5.1 版本匹配驱动、浏览器与Selenium这是Selenium自动化中最经典的“坑”。三者版本必须兼容。检查Edge浏览器版本在浏览器地址栏输入edge://settings/help查看版本号例如128.0.2739.79。下载匹配的msedgedriver访问 Microsoft Edge WebDriver官方下载站 。下载与你的Edge浏览器主版本号前三位完全一致的驱动。例如Edge版本是128.0.2739.79就下载128.0.2739.xx的驱动。确保使用Selenium 4旧版Selenium 3已不再被支持。通过包管理器更新Python:pip install --upgrade seleniumJava: 在Maven的pom.xml中确保selenium-java依赖版本 4.0.0C#: 通过NuGet安装Selenium.WebDriver 4.0.05.2 驱动程序的放置与PATH配置有两种常见方式让Selenium找到msedgedriver.exe方法一添加到系统PATH推荐一次配置长期使用将下载的msedgedriver.exe解压到一个固定目录如C:\WebDriver\或/usr/local/bin/。将该目录路径添加到系统的环境变量PATH中。重启你的IDE或命令行终端。之后在代码中可以直接使用webdriver.Edge()Selenium会自动在PATH中查找。方法二在代码中指定路径灵活适合多版本管理from selenium.webdriver.edge.service import Service service Service(executable_pathr你的\具体\路径\msedgedriver.exe) driver webdriver.Edge(serviceservice, optionsyour_options)6. 进阶配置与场景化应用解决了基本问题后我们可以根据不同的测试场景对浏览器进行更精细的配置。6.1 无头模式Headless运行在服务器或CI/CD流水线中运行测试时通常不需要图形界面。无头模式可以节省资源提高速度。edge_options.add_argument(--headlessnew) # 推荐使用新的Headless模式 edge_options.add_argument(--disable-gpu) # 在Windows上无头模式建议禁用GPU edge_options.add_argument(--window-size1920,1080) # 设置初始窗口大小确保布局一致注意事项新的--headlessnew模式比旧的--headless更稳定对现代Web特性的支持更好。务必在无头模式下也加上屏蔽提示的参数因为提示虽然不显示在屏幕上但其产生的内部事件仍可能干扰脚本。6.2 用户数据目录与登录态保持有时测试需要已登录的状态。你可以指定一个用户数据目录让浏览器记住cookies和本地存储。user_data_dir rC:\Temp\EdgeAutomationProfile edge_options.add_argument(f--user-data-dir{user_data_dir}) # 通常还需要指定配置文件目录 edge_options.add_argument(f--profile-directoryDefault)警告不要同时运行多个使用相同用户数据目录的浏览器实例这会导致数据损坏。在并行测试中应为每个实例创建独立的、临时的新目录。6.3 禁用沙箱与共享内存限制在Docker容器或某些Linux服务器环境中可能会遇到因沙箱安全模型或/dev/shm空间不足导致的崩溃。可以添加以下参数edge_options.add_argument(--no-sandbox) # 禁用沙箱有安全风险仅限受控测试环境 edge_options.add_argument(--disable-dev-shm-usage) # 使用磁盘临时文件替代/dev/shm7. 常见问题排查与解决方案实录即使按照步骤操作你可能还是会遇到一些问题。这里记录了我踩过的坑和解决方法。7.1 问题代码运行后提示栏依然存在可能原因1参数顺序或拼写错误。仔细检查add_experimental_option的键名是excludeSwitches和useAutomationExtension确保大小写和拼写完全正确。可能原因2浏览器或驱动版本太旧。请严格遵循第5.1节的版本匹配指南使用最新的稳定版Edge和对应的驱动。可能原因3浏览器缓存或用户配置文件干扰。尝试以全新的、无缓存的临时配置文件启动浏览器。可以在代码中添加edge_options.add_argument(--incognito)启动无痕模式测试或者确保--user-data-dir指向一个全新的空目录。排查步骤在options中添加edge_options.add_argument(--remote-debugging-port9222)然后手动用edge.exe --remote-debugging-port9222命令启动浏览器观察启动参数是否生效。7.2 问题Selenium抛出SessionNotCreatedException或驱动相关错误错误信息示例WebDriverException: Message: unknown error: cannot find Microsoft Edge binary解决确保Edge浏览器已正确安装。或者通过options.binary_location显式指定Edge可执行文件的路径。options.binary_location rC:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe错误信息示例WebDriverException: Message: ‘msedgedriver’ executable needs to be in PATH.解决参考第5.2节将msedgedriver正确放入PATH或通过Service类指定路径。7.3 问题在CI服务器如Jenkins, GitLab CI上运行失败场景脚本在本地开发机运行良好但在无图形界面的CI服务器上报错或卡住。解决方案必须使用无头模式添加--headlessnew参数。安装必要的依赖在Linux CI服务器上确保安装了浏览器运行所需的库。对于基于Debian的系统如Ubuntu可以运行sudo apt-get update sudo apt-get install -y wget curl unzip libnss3 libatk-bridge2.0-0 libdrm2 libxkbcommon0 libgbm1 libasound2使用虚拟显示缓冲区Xvfb如果某些旧版测试框架或截图工具依赖显示环境可以在无头服务器上安装Xvfb。sudo apt-get install -y xvfb # 在运行测试脚本前启动Xvfb Xvfb :99 -screen 0 1920x1080x24 export DISPLAY:997.4 问题脚本运行一段时间后变慢或内存占用过高原因浏览器实例未正确关闭导致内存泄漏或者每个测试用例都创建/销毁浏览器开销大。优化建议务必在finally块或teardown方法中调用driver.quit()而不是driver.close()。quit()会关闭整个浏览器进程和相关驱动释放所有资源。考虑使用单例模式或复用浏览器会话对于一组关联的测试可以只启动一次浏览器在所有测试完成后关闭。但要注意测试之间的状态隔离清理cookies、localStorage。调整浏览器参数禁用不必要的功能以节省资源。edge_options.add_argument(--disable-extensions) # 禁用所有扩展 edge_options.add_argument(--disable-popup-blocking) edge_options.add_argument(--disable-notifications) edge_options.add_argument(--disable-infobars) # 禁用信息栏8. 完整实战示例一个健壮的自动化测试脚本模板结合以上所有要点我为你准备了一个可以直接用于生产环境的Python脚本模板。它包含了错误处理、日志记录和配置分离等最佳实践。# robust_edge_automation.py import logging import sys from pathlib import Path from selenium import webdriver from selenium.webdriver.edge.service import Service from selenium.webdriver.edge.options import Options from selenium.common.exceptions import WebDriverException, TimeoutException from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC from selenium.webdriver.common.by import By def setup_logging(): 配置日志 logging.basicConfig( levellogging.INFO, format%(asctime)s - %(name)s - %(levelname)s - %(message)s, handlers[ logging.FileHandler(edge_automation.log), logging.StreamHandler(sys.stdout) ] ) return logging.getLogger(__name__) def create_stealth_edge_driver(driver_pathNone, headlessFalse): 创建一个隐形的、无干扰的Edge浏览器驱动实例。 Args: driver_path (str, optional): msedgedriver.exe的完整路径。如果为None则从PATH查找。 headless (bool): 是否以无头模式运行。 Returns: webdriver.Edge: 配置好的WebDriver实例。 logger logging.getLogger(__name__) options Options() # 核心屏蔽“被控制”提示 options.add_experimental_option(excludeSwitches, [enable-automation]) options.add_experimental_option(useAutomationExtension, False) # 优化参数 options.add_argument(--disable-blink-featuresAutomationControlled) options.add_argument(--disable-infobars) options.add_argument(--disable-notifications) # 设置初始窗口大小确保响应式布局测试一致性 options.add_argument(--window-size1920,1080) if headless: options.add_argument(--headlessnew) options.add_argument(--disable-gpu) # 无头模式下某些资源加载策略可能不同可以禁用图片加速测试 # prefs {profile.managed_default_content_settings.images: 2} # options.add_experimental_option(prefs, prefs) # 配置服务 service None if driver_path: service Service(executable_pathdriver_path) logger.info(f使用指定驱动路径: {driver_path}) else: service Service() logger.info(从系统PATH查找EdgeDriver) try: driver webdriver.Edge(serviceservice, optionsoptions) logger.info(EdgeDriver实例创建成功) except WebDriverException as e: logger.error(f创建EdgeDriver失败: {e}) raise # 注入脚本以覆盖navigator.webdriver针对高级反爬场景 try: driver.execute_cdp_cmd(Page.addScriptToEvaluateOnNewDocument, { source: Object.defineProperty(navigator, webdriver, { get: () undefined }); Object.defineProperty(navigator, plugins, { get: () [1, 2, 3, 4, 5], }); Object.defineProperty(navigator, languages, { get: () [zh-CN, zh, en], }); }) logger.info(已注入反检测脚本) except Exception as e: logger.warning(f注入CDP脚本时发生警告不影响主要功能: {e}) return driver def main(): logger setup_logging() driver None try: # 创建驱动实例无头模式适用于CI环境 driver create_stealth_edge_driver(headlessFalse) # 设置隐式等待全局等待元素出现的超时时间 driver.implicitly_wait(10) # 访问目标页面 target_url https://www.bing.com logger.info(f正在访问: {target_url}) driver.get(target_url) # 使用显式等待等待特定元素出现更可靠 wait WebDriverWait(driver, 15) search_box wait.until( EC.presence_of_element_located((By.ID, sb_form_q)) ) logger.info(成功定位到搜索框) # 执行操作 search_box.send_keys(Selenium自动化测试) search_box.submit() # 等待结果加载 wait.until(EC.title_contains(Selenium)) logger.info(f搜索结果页标题: {driver.title}) # 截图保存此时应无“被控制”提示栏 screenshot_path Path(test_result.png) driver.save_screenshot(str(screenshot_path)) logger.info(f截图已保存至: {screenshot_path}) # 这里可以继续你的测试逻辑... # 例如断言页面元素、提取数据等 except TimeoutException as e: logger.error(f操作超时元素未在指定时间内出现: {e}) if driver: driver.save_screenshot(timeout_error.png) except WebDriverException as e: logger.error(fWebDriver发生错误: {e}) except Exception as e: logger.error(f发生未知错误: {e}, exc_infoTrue) finally: # 无论如何最终都要关闭驱动释放资源 if driver: driver.quit() logger.info(EdgeDriver已退出资源已释放) if __name__ __main__: main()这个模板提供了完整的错误处理、日志记录和资源管理。你可以直接复制使用并根据自己的测试用例修改main函数中的操作逻辑。关键点在于create_stealth_edge_driver函数它封装了所有屏蔽提示和优化浏览器的配置是你自动化测试的坚实起点。