如何使用Python Selenium WebDriver启动带全量用户数据的浏览器

Selenium默认每次启动浏览器都会生成一个独立的临时干净用户目录，不会读取你本地日常使用的浏览器留存数据。要实现启动后完整加载浏览历史、Cookie、扩展、站点偏好、保存的密码等全量用户轨迹，核心是跳过自动生成临时目录的逻辑，直接把本地真实的用户数据路径映射给WebDriver的启动参数。

核心配置步骤 #

• 操作前必须完全关闭所有正在运行的目标浏览器进程：别只关可视化的窗口，要通过任务管理器把对应浏览器的所有后台常驻进程全部结束——用户数据目录一旦被运行中的浏览器锁定，Selenium启动时会直接报权限占用错误，根本加载不了数据。
• 两个必须配对设置的启动参数，漏设任何一个都没法实现全量加载：
  • user-data-dir：指向你本地浏览器的用户数据根目录，不是目录下的某个子文件/文件夹。常见的默认路径参考：
    • Windows下Chrome：C:\Users\你的用户名\AppData\Local\Google\Chrome\User Data
    • Mac下Chrome：~/Library/Application Support/Google/Chrome
    • Linux下Chrome：~/.config/google-chrome
    • 同路径规则替换成Microsoft Edge相关的目录名，就能适用于Edge浏览器。
  • profile-directory：指向你日常实际使用的那个用户配置子目录，大多数人日常默认使用的配置文件夹名为Default，如果有多个浏览器用户profile，就填对应profile的文件夹名（比如Profile 1、Profile 2这类），不设这个参数就算指对了根目录，也会因为没匹配到具体配置读不到对应的数据。

可直接复用的配置代码示例（Chrome） #

from selenium import webdriver
from selenium.webdriver.chrome.service import Service

# 初始化Chrome启动参数对象
chrome_options = webdriver.ChromeOptions()
# 替换成你本地实际的用户数据根目录路径
chrome_options.add_argument(r"user-data-dir=C:\Users\你的电脑用户名\AppData\Local\Google\Chrome\User Data")
# 替换成你日常使用的profile对应的文件夹名
chrome_options.add_argument("profile-directory=Default")

# 初始化驱动，注意驱动版本要和你本地安装的浏览器版本完全匹配
chrome_service = Service(executable_path=r"D:\你存放chromedriver的路径\chromedriver.exe")
driver = webdriver.Chrome(service=chrome_service, options=chrome_options)

常见踩坑说明 #

• 不要单独用导出Cookie、复制历史文件的方式实现数据留存：这类操作没法加载你安装的扩展、站点权限设置、保存的表单偏好、已登录的扩展状态，和真实日常使用的浏览器状态有明显差异，直接映射本地真实目录是唯一能拿到全量状态的方案。
• 不要在配置中加入隐身模式参数（--incognito）：隐身模式下浏览器不会读写任何本地用户数据，就算指对了真实目录，也读不到留存的历史、Cookie数据，更不会把自动化操作的轨迹写入本地目录。
• 如果是在Linux服务器、root权限环境下运行配置，可能会出现Chrome沙箱权限不足导致读不到用户目录下文件的问题，这种情况可以额外加--no-sandbox启动参数补全权限，但本地日常使用时不要随便加这个参数，会降低浏览器的安全防护等级。
• 出现启动后数据没加载全的情况，优先检查两个点：一是是不是profile-directory设错了对应文件夹，二是不是后台还有浏览器进程占着用户数据目录的锁。

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