如何使用Python+Selenium连接手动打开的Firefox窗口

你之前调用browser.window_handles无法识别手动打开的Firefox窗口，核心原因是Selenium与Firefox的交互基于Marionette自动化协议，无参数初始化的selenium.Firefox()实例只会绑定自身通过geckodriver拉起的、开放了Marionette调试端口的Firefox进程，没有权限访问未开启调试接口的独立Firefox进程，自然无法枚举对应窗口的句柄。

要实现关联手动打开的Firefox窗口，不需要修改Selenium底层逻辑，只需要在手动启动Firefox时提前开启指定端口的Marionette调试权限，再让Selenium通过该端口连接已有进程即可，具体操作如下：

步骤1：启动带调试权限的手动Firefox窗口 #

• 先彻底关闭所有正在运行的Firefox进程，避免进程复用导致调试端口不生效
• 打开系统命令行工具，进入Firefox安装路径，执行对应启动命令：
  • Windows：

    firefox.exe --marionette --marionette-port 2828 --start-debugger-server 2828 -no-remote
    

  • macOS：

    /Applications/Firefox.app/Contents/MacOS/firefox --marionette --marionette-port 2828 --start-debugger-server 2828 -no-remote
    

  • Linux：

    firefox --marionette --marionette-port 2828 --start-debugger-server 2828 -no-remote
    

• 命令执行后会拉起独立的Firefox窗口，你可以在这个窗口内提前完成密码管理器授权、账号登录等操作，保留所有本地登录态，操作完成后不要关闭窗口。

步骤2：Selenium端配置连接已有进程 #

不要使用无参的selenium.Firefox()初始化实例，需要指定geckodriver的连接参数，绑定刚才开放的2828调试端口，示例代码（Python版）如下：

from selenium import webdriver
from selenium.webdriver.firefox.service import Service
from selenium.webdriver.firefox.options import Options

# 配置Firefox选项，设置连接后不自动关闭浏览器
firefox_opts = Options()
firefox_opts.add_experimental_option("detach", True)

# 配置geckodriver服务，指定连接已存在的Firefox进程，对应Marionette端口为2828
gecko_service = Service(
    service_args=['--marionette-port', '2828', '--connect-existing']
)

# 初始化实例，此时会直接关联到你之前手动打开的Firefox窗口
browser = webdriver.Firefox(service=gecko_service, options=firefox_opts)

# 验证连接：此时打印返回的句柄列表会包含手动打开窗口下的所有标签页
print(browser.window_handles)

注意事项 #

• 手动启动Firefox时指定的Marionette端口，需要和Selenium端配置的端口保持一致，且确保端口未被其他进程占用
• 必须彻底退出所有旧的Firefox进程再执行带参数的启动命令，否则Firefox会默认唤起已有的无调试权限的进程，导致Selenium连接失败
• 连接成功后，Selenium对该窗口的操作权限和自启动实例完全一致，可正常执行元素定位、页面交互、标签页切换等所有操作，同时完整保留你在手动操作时留存的Cookie、本地存储、登录态数据
• 该方案完全适配密码管理器类场景：不需要将账号密码、二次验证密钥硬编码在项目代码中，只需要提前在手动启动的Firefox窗口完成一次登录授权，后续Selenium连接后可直接复用登录状态，避免凭证存储带来的安全隐患。

内容的提问来源于stack exchange，提问作者Mr. PRAINGLE