本文详解 Selenium 4.6 及以上版本中 SessionNotCreatedException: Expected browser binary location 错误的成因，重点指出手动设置 webdriver.gecko.driver 系统属性已过时，并提供基于 Selenium Manager 的零配置、自动兼容方案。
本文详解 selenium 4.6 及以上版本中 `sessionnotcreatedexception: expected browser binary location` 错误的成因，重点指出手动设置 `webdriver.gecko.driver` 系统属性已过时，并提供基于 selenium manager 的零配置、自动兼容方案。
当你在 Selenium 4.9.1（当前主流稳定版）中执行以下经典写法时：
System.setProperty("webdriver.gecko.driver", "D:\Selenium\BrowserJars\geckodriver113.exe");
WebDriver driver = new FirefoxDriver();会触发如下关键错误：
SessionNotCreatedException: Expected browser binary location, but unable to find binary in default location...
这不是驱动没找到，而是逻辑冲突所致 —— Selenium 4.6+ 已彻底弃用 System.setProperty() 手动指定驱动路径的方式。该方式不仅冗余，更会干扰 Selenium 内置的 Selenium Manager 自动化机制，导致其无法正确探测 Firefox 安装路径、自动匹配 geckodriver 版本，甚至掩盖真正的浏览器二进制位置问题。
✅ 正确做法：拥抱 Selenium Manager（推荐）
Selenium Manager 是 Selenium 4.6 引入的默认驱动管理器，它会在运行时自动完成：
- 检测已安装的 Firefox 版本（如你使用的 v113）；
- 下载并缓存匹配的 geckodriver（如 v0.33.0）；
- 定位系统中 Firefox 的真实安装路径（如 C:Program FilesMozilla Firefox irefox.exe 或你的 D:... 路径）；
- 启动驱动服务并建立会话 —— 全程无需人工干预。
只需删除过时代码，直接初始化即可：
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
public class BrowserTest {
public static void main(String[] args) {
// ✅ 删除这一行！Selenium Manager 会自动处理
// System.setProperty("webdriver.gecko.driver", "...");
// ✅ 简洁启动：Selenium 自动下载/匹配/调用
WebDriver driver = new FirefoxDriver();
driver.get("https://www.mozilla.org");
System.out.println("Firefox launched successfully: " + driver.getTitle());
driver.quit();
}
}? 前提条件：确保项目依赖为 selenium-java 4.6.0+（你当前的 4.9.1 完全满足），且网络通畅（首次运行需自动下载驱动）。
⚠️ 若仍失败？请按此顺序排查
| 问题类型 | 检查项 | 解决方案 |
|---|---|---|
| Firefox 未安装或路径异常 | 运行 where firefox.exe（Windows CMD）或检查是否安装在非标准路径（如 D:Program FilesMozilla Firefox） | 在代码中显式指定二进制路径： java<br>FirefoxOptions options = new FirefoxOptions();<br>options.setBinary("D:\Program Files\Mozilla Firefox\firefox.exe");<br>WebDriver driver = new FirefoxDriver(options);<br> |
| GeckoDriver 版本强绑定旧逻辑 | 手动放置的 geckodriver113.exe 文件仍在项目目录或 PATH 中 | 彻底删除所有手动下载的 .exe 驱动文件，避免 Selenium Manager 加载冲突 |
| 权限/安全软件拦截 | Windows Defender 或第三方杀软可能阻止 geckodriver 启动 | 临时禁用实时防护，或添加 geckodriver.exe 到白名单（Selenium Manager 下载路径通常位于 %USERPROFILE%.cacheselenium） |
| Java 8 兼容性注意 | 你使用的是 JDK 8u172（较老），虽支持 Selenium 4.9，但建议升级至 JDK 11+ | 更新 JDK 并验证 java -version，避免潜在 TLS/HTTP client 兼容问题 |
? 关键总结与最佳实践
- *永远不要在 Selenium ≥4.6 中调用 `System.setProperty("webdriver..driver", ...)`** —— 这是反模式，会破坏自动化流程；
- Selenium Manager 默认启用，无需额外配置；若需禁用（极少数调试场景），可通过系统属性关闭：System.setProperty("selenium.manager", "false")；
- Firefox 二进制路径缺失是主因：Selenium Manager 能自动发现常规安装路径，但对自定义路径（如 D 盘便携版）需通过 FirefoxOptions.setBinary() 显式声明；
- 版本严格对应：Firefox v113 → geckodriver v0.33.0（Selenium Manager 会自动校验并下载，无需人工查表）；
- 日志诊断利器：启用详细日志定位问题：System.setProperty("selenium.logging", "DEBUG")，观察 Manager 是否成功下载驱动及探测浏览器。
遵循以上方案，你将告别繁琐的驱动版本管理，让 Firefox 启动回归“一行代码即运行”的现代自动化体验。
