Mac系统下Geckodriver安装及Firefox路径识别问题求助

环境配置：

• Eclipse + Java
• MacOS 14.5
• Firefox 126.0.1（64位）
• Geckodriver 0.34.0（macOS版本）
• Selenium版本：3.141.59

Firefox位于/Applications/Firefox.app，Geckodriver曾放置在Downloads或/usr/local/bin，但启动时持续报错：

Exception in thread "main" org.openqa.selenium.WebDriverException: Cannot find firefox binary in PATH. Make sure firefox is installed. OS appears to be: MAC
Build info: version: '3.141.59', revision: 'e82be7d358', time: '2018-11-14T08:25:48'
System info: host: 'Cicilias-MacBook-Pro.local', ip: '2403:4800:280e:9d01:48ca:24b2:de1f:b289%en0', os.name: 'Mac OS X', os.arch: 'x86_64', os.version: '14.5', java.version: '17.0.10'
Driver info: driver.version: FirefoxDriver
at org.openqa.selenium.firefox.FirefoxBinary.<init>(FirefoxBinary.java:100)
at java.base/java.util.Optional.orElseGet(Optional.java:364)
at org.openqa.selenium.firefox.FirefoxOptions.getBinary(FirefoxOptions.java:216)
at org.openqa.selenium.firefox.FirefoxDriver.toExecutor(FirefoxDriver.java:187)
at org.openqa.selenium.firefox.FirefoxDriver.<init>(FirefoxDriver.java:147)
at org.openqa.selenium.firefox.FirefoxDriver.<init>(FirefoxDriver.java:125)
at Firefox.runner.main(runner.java:15)

当前代码：

package Firefox;

import org.openqa.selenium.firefox.FirefoxDriver;

public class runner {

    public static void main(String[] args) {
        
        System.setProperty("webdriver.gecko.driver", 
            "/Users/ciciliaprasetio/Downloads/geckodriver");
        
        FirefoxDriver driver = new FirefoxDriver();
        
        driver.get("http://www.facebook.com");

    }

}

已尝试但无效的操作：

• 将Geckodriver移至/usr/local/bin
• 设置webdriver.firefox.bin系统属性
• 通过MacPorts安装Geckodriver

1. 确认Firefox二进制文件路径 #

MacOS上Firefox的默认二进制路径是/Applications/Firefox.app/Contents/MacOS/firefox，先验证路径有效性：
打开终端执行：

ls /Applications/Firefox.app/Contents/MacOS/firefox

若返回文件路径则正常；若提示不存在，检查Firefox是否真的安装在/Applications下，或是否为特殊版本（比如Firefox Developer Edition的路径是/Applications/Firefox Developer Edition.app/Contents/MacOS/firefox）。

2. 用FirefoxOptions指定二进制路径（推荐） #

旧版Selenium 3.x无法自动识别MacOS上的Firefox app路径，直接在代码中通过FirefoxOptions指定二进制文件，替代系统属性设置：

package Firefox;

import org.openqa.selenium.firefox.FirefoxDriver;
import org.openqa.selenium.firefox.FirefoxOptions;

public class runner {

    public static void main(String[] args) {
        
        System.setProperty("webdriver.gecko.driver", "/Users/ciciliaprasetio/Downloads/geckodriver");
        
        // 指定Firefox二进制路径
        FirefoxOptions options = new FirefoxOptions();
        options.setBinary("/Applications/Firefox.app/Contents/MacOS/firefox");
        
        FirefoxDriver driver = new FirefoxDriver(options);
        
        driver.get("http://www.facebook.com");

    }

}

3. 给Geckodriver添加执行权限 #

终端执行以下命令为Geckodriver赋予执行权限：

chmod +x /Users/ciciliaprasetio/Downloads/geckodriver

若已移至/usr/local/bin，则执行：

chmod +x /usr/local/bin/geckodriver

4. 解决版本兼容性问题 #

你的Selenium版本是2018年的3.141.59，与Firefox 126.0.1版本差距过大，存在兼容性问题。建议升级Selenium：

• 若保留3.x系列，确保使用3.x的最终版本（3.141.59是最后一个3.x版本，仍可能存在适配问题）
• 优先升级到Selenium 4.x，该版本支持自动驱动管理，无需手动设置webdriver.gecko.driver系统属性（需确保Geckodriver在PATH中，或使用WebDriverManager自动管理）

如果使用Maven，修改pom.xml中的依赖：

<!-- 升级到Selenium 4.x最新版 -->
<dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-java</artifactId>
    <version>4.21.0</version> <!-- 替换为最新4.x版本号 -->
</dependency>

5. 验证Geckodriver的PATH配置 #

终端执行以下命令查看PATH是否包含Geckodriver所在目录：

echo $PATH

若/usr/local/bin不在输出中，将其添加到PATH：
打开终端编辑~/.zshrc（MacOS 14默认使用zsh）：

open ~/.zshrc

添加一行：

export PATH="/usr/local/bin:$PATH"

保存后执行：

source ~/.zshrc

验证Geckodriver是否可被系统识别：

geckodriver --version

返回版本信息则说明PATH配置正确。

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