1. 项目概述为什么我们需要免登录自动化做自动化测试或者数据抓取的朋友肯定都遇到过登录这个“拦路虎”。每次脚本运行都得先过登录这一关输入账号密码、处理验证码不仅效率低下还容易因为登录环节的变动比如验证码升级、登录流程调整导致整个脚本瘫痪。更头疼的是对于一些需要高频次、短间隔执行的任务反复登录不仅浪费资源还可能因为频繁请求触发系统的风控机制导致账号被临时锁定。这时候“免登录”技术就成了我们的“金钥匙”。它的核心思路很简单模拟一个已经登录成功的会话状态。想象一下你手动登录一个网站后浏览器会收到服务器发来的一个“通行证”Cookie或者一个“门禁卡”Token。之后你再访问网站内的其他页面只需要出示这个“通行证”或“门禁卡”服务器就认得你无需再次验证身份。在Python的Selenium自动化中实现免登录主要就是围绕如何获取并复用这个“通行证”Cookie或“门禁卡”Token来展开的。这不仅仅是跳过登录框那么简单它直接关系到脚本的稳定性、执行效率和维护成本。一个成熟的免登录方案能让你的自动化脚本从“实验室玩具”升级为“生产级工具”。2. 核心原理拆解Cookie与Token的异同及工作逻辑在动手之前我们必须搞清楚我们操作的对象到底是什么。Cookie和Token虽然目标一致——维持会话状态但它们的生成、存储和验证机制有本质区别。2.1 Cookie由服务器“签发”的通行证Cookie是Web开发中最经典的会话保持机制。它的工作流程非常直观客户端发起登录请求用户提交账号密码。服务器验证并“签发”服务器验证成功后会在HTTP响应头中通过Set-Cookie字段将一个或多个Cookie发送给浏览器。这个Cookie里通常包含一个唯一的会话IDSession ID。浏览器自动存储与携带浏览器会将这些Cookie保存在本地内存或硬盘。此后浏览器向该域名下的任何页面发起请求时都会自动在HTTP请求头中通过Cookie字段将这些Cookie回传给服务器。服务器“验票”服务器收到请求后解析Cookie中的会话ID在自己的会话存储如内存、Redis中查找对应的会话信息。如果找到且未过期就认为用户已登录。在Selenium中的体现Selenium WebDriver完全模拟了浏览器的行为。当我们使用driver.get_cookies()获取Cookie时拿到的是浏览器当前为这个域名存储的所有Cookie键值对。而driver.add_cookie()方法则是手动向浏览器的Cookie存储区插入一条记录模拟浏览器收到了一个Set-Cookie指令。注意Cookie有作用域Domain和Path。你只能为当前浏览器访问的域名添加Cookie。通常你需要先driver.get(“域名首页”)来确立域名上下文然后再添加Cookie。2.2 Token自包含的“数字门禁卡”Token通常指JWT - JSON Web Token是一种更现代、常用于前后端分离架构如单页应用SPA、手机APP接口的认证方式。它与Cookie的关键区别在于状态存储的位置。客户端发起登录请求用户提交凭证。服务器生成Token并返回服务器验证成功后生成一个Token字符串返回给客户端通常在HTTP响应体里如{“token”: “xxx”}。这个Token字符串本身经过加密签名包含了用户身份、有效期等信息服务器不需要在内存中保存这个Token。客户端主动携带Token客户端如浏览器中的JavaScript需要手动将这个Token保存起来常用localStorage或SessionStorage。在后续请求中需要手动将其添加到HTTP请求头中通常是Authorization: Bearer token。服务器“验签”服务器收到请求后用预存的密钥对Token的签名进行验证并解析其中的载荷信息。只要签名有效且未过期就认为请求合法。在Selenium中的体现对于使用Token认证的网页情况更复杂一些。因为Token通常不由浏览器自动管理。Selenium无法直接通过add_cookie来设置Token。常见的做法有两种通过JavaScript注入将Token写入浏览器的本地存储LocalStorage/SessionStorage。因为很多前端框架如Vue、React会从本地存储读取Token。拦截并修改请求头这需要更高级的技巧比如使用Selenium Wire一个增强版Selenium或切换到Playwright/Puppeteer它们提供了更强大的网络请求拦截和修改能力。选择Cookie还是Token看目标网站的技术栈传统Web应用多用Cookie现代前后端分离应用、手机APP接口多用Token。看获取难度Cookie通过浏览器开发者工具F12 - Application - Cookies很容易直接查看和复制。Token则需要到Network标签页查看登录成功后的API响应体或者查看后续请求的Headers。看维护成本Cookie可能有过期时间需要定期更新。Token也有过期时间但因其自包含有时可以通过刷新令牌Refresh Token机制来获取新的。3. 基于Cookie的免登录实战详解这是最常见、最直接的免登录方式适用于绝大多数传统网站。下面我们以一个需要登录的论坛或管理系统为例分步拆解。3.1 第一步手动登录并获取Cookie在编写自动化脚本之前我们需要先手动获取一次有效的登录Cookie。操作流程打开Chrome浏览器按F12打开开发者工具。切换到Network网络标签页勾选Preserve log保留日志。访问目标网站登录页完成一次成功的登录。在Network列表中找到登录请求通常是login、signin等查看其Response Headers响应头里面会有Set-Cookie字段。或者更简单的方法是登录成功后刷新页面或跳转到任意需要登录的页面如个人中心。在开发者工具中切换到Application应用程序标签页Chrome在左侧找到Storage - Cookies - [网站域名]。这里会列出所有当前域名下的Cookie。我们需要找到那个最关键、通常名为sessionid、JSESSIONID、auth_token等的Cookie。将其名称Name和值Value记录下来。注意不要泄露这个值它等同于你的登录密码。实操心得有些网站的Cookie是HttpOnly的这意味着JavaScript无法读取它这增强了安全性。但Selenium的get_cookies()方法仍然可以获取到因为它在浏览器层面操作。除了name和valueCookie还有domain、path、expiry过期时间戳、secure是否仅HTTPS、httpOnly等属性。在后续添加时尽量保证这些属性一致尤其是domain。3.2 第二步编写Selenium脚本复用Cookie获取到Cookie后我们就可以编写脚本在启动浏览器后直接注入Cookie跳过登录页面。from selenium import webdriver import time import json # 1. 启动浏览器 driver webdriver.Chrome() driver.implicitly_wait(10) # 设置隐式等待 try: # 2. 关键步骤必须先访问目标域名以确立Cookie的作用域 # 这里访问首页不一定是登录页只要是同域名下的任意页面即可 driver.get(https://www.target-website.com/) time.sleep(2) # 等待页面基础加载 # 3. 准备要添加的Cookie # 方式一直接构造字典适用于单个或少量明确知道的Cookie login_cookie { name: sessionid, # 替换为你的Cookie名称 value: your_actual_session_id_value_here, # 替换为你的Cookie值 domain: .target-website.com, # 注意域名前的点表示包括所有子域名 path: /, # expiry: 1719859200, # Unix时间戳可选。如果已知过期时间可以加上 httpOnly: True, # 根据实际情况设置 secure: True # 如果网站是HTTPS通常为True } # 方式二从之前保存的JSON文件中加载推荐便于管理多个Cookie # with open(cookies.json, r) as f: # cookies_list json.load(f) # for cookie_dict in cookies_list: # driver.add_cookie(cookie_dict) # 4. 添加Cookie到浏览器 driver.add_cookie(login_cookie) # 5. 再次访问需要登录后才能看的页面 driver.get(https://www.target-website.com/user/profile) # 6. 验证是否成功 # 通过检查页面特定元素来判断例如个人中心独有的“欢迎XXX”字样 time.sleep(3) welcome_element driver.find_element(css selector, .welcome-text) if 你的用户名 in welcome_element.text: print(免登录成功) else: print(可能未登录成功请检查Cookie。) # 后续可以进行你的自动化操作... # driver.find_element(...).click() except Exception as e: print(f操作过程中发生错误: {e}) # 可以在这里截图方便排查 driver.save_screenshot(error.png) finally: # 7. 关闭浏览器 time.sleep(5) # 演示用实际可去掉 driver.quit()注意事项与避坑指南domain属性的坑这是最容易出错的地方。通过get_cookies()获取的Cookie对象其domain字段可能类似于.target-website.com前面有点。在add_cookie时domain必须和当前浏览器地址栏的域名匹配或为其父域。一个稳妥的做法是driver.get(“基础域名”)后添加Cookie时使用从get_cookies()获取到的原始domain值。添加Cookie的时机必须在driver.get()访问了同域名的页面之后才能添加。你不能在浏览器刚启动about:blank页面或访问一个不同域名的页面时添加。过期问题Cookie有生命周期。从get_cookies()获取的Cookie字典里可能包含expiry字段它是一个Unix时间戳秒。如果你保存的Cookie已经过期那么添加后也是无效的。需要定期更新Cookie文件。安全Cookie如果Cookie的secure属性为True意味着它只能通过HTTPS连接传输。那么你的driver.get()的初始网址也必须是https://开头否则添加会失败。验证方式不要仅凭页面URL变化判断登录成功。一定要通过查找登录后页面独有的元素如用户名、退出按钮来进行断言这是自动化测试的基本素养。3.3 第三步Cookie的持久化与自动化更新对于需要长期运行的脚本手动复制Cookie太低效。我们可以将获取Cookie和注入Cookie的过程都自动化。方案A半自动维护Cookie池编写一个单独的“Cookie获取脚本”定期手动运行一次比如每周一早上用你的账号登录并保存Cookie。# save_cookies.py - 用于获取并保存Cookie from selenium import webdriver import json import time def get_and_save_cookies(): driver webdriver.Chrome() driver.get(https://www.target-website.com/login) # **这里是需要手动干预的部分** print(请在浏览器中手动完成登录...) print(登录成功后程序将在10秒后自动保存Cookie。) time.sleep(10) # 给你足够的时间手动输入密码、验证码 # 登录成功后跳转到任意页面确保Cookie生效 driver.get(https://www.target-website.com/) # 获取所有Cookie cookies driver.get_cookies() # 保存到文件 with open(cookies.json, w) as f: json.dump(cookies, f, indent2) print(fCookie已保存到 cookies.json共 {len(cookies)} 条。) driver.quit() if __name__ __main__: get_and_save_cookies()然后在你的主自动化脚本中直接加载这个cookies.json文件。方案B全自动处理适用于无复杂验证码的登录如果登录流程简单无图形验证码、无滑块等可以尝试用Selenium模拟输入用户名密码来自动获取Cookie。但这需要处理登录表单且一旦登录流程变化脚本就失效稳定性不如直接复用Cookie。# auto_login_and_get_cookies.py from selenium.webdriver.common.by import By from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC def auto_login(driver, username, password): driver.get(https://www.target-website.com/login) wait WebDriverWait(driver, 10) user_input wait.until(EC.presence_of_element_located((By.ID, username))) pass_input driver.find_element(By.ID, password) submit_btn driver.find_element(By.CSS_SELECTOR, button[typesubmit]) user_input.send_keys(username) pass_input.send_keys(password) submit_btn.click() # 等待登录成功例如跳转到首页或出现用户菜单 wait.until(EC.url_contains(/home) or EC.presence_of_element_located((By.CLASS_NAME, user-menu))) print(自动登录成功。) return driver.get_cookies()4. 基于Token的免登录实战进阶对于使用Token认证的现代Web应用如Vue、React构建的管理后台Cookie方案可能失效。因为这些应用的前端在登录后会将Token保存在浏览器的本地存储LocalStorage/SessionStorage中后续的API请求通过JavaScript在请求头中添加Authorization: Bearer token。Selenium的标准API无法直接操作LocalStorage但我们可以通过执行JavaScript代码来实现。4.1 获取Token和获取Cookie类似你需要手动登录一次然后在开发者工具的Network标签页中找到登录成功的那个XHR/Fetch请求通常是/api/login。查看其Response标签页在响应体Response Body中找到Token。它通常是一个JSON对象如{“access_token”: “eyJhbGciOi...”, “token_type”: “bearer”, “expires_in”: 3600}。复制access_token的值。4.2 通过JavaScript注入Token拿到Token后我们在Selenium脚本中先访问网站然后通过execute_script方法将Token写入LocalStorage。from selenium import webdriver import time driver webdriver.Chrome() driver.implicitly_wait(10) try: # 1. 访问网站前端页面通常是首页或登录页 driver.get(https://app.target-website.com) time.sleep(2) # 2. 准备Token这里替换成你实际获取的Token access_token eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... token_key auth_token # 这个Key需要根据目标网站的前端代码确定可能是token, access_token, userToken等 # 3. 通过JavaScript将Token写入LocalStorage js_code fwindow.localStorage.setItem({token_key}, {access_token}); driver.execute_script(js_code) # 4. 可选同时写入Token到SessionStorage如果前端从这里读 # js_code_session fwindow.sessionStorage.setItem({token_key}, {access_token}); # driver.execute_script(js_code_session) print(Token已注入LocalStorage。) # 5. 刷新页面让前端JavaScript读取到新的Token并初始化登录状态 driver.refresh() time.sleep(3) # 等待前端应用重新初始化 # 6. 验证访问一个需要认证的页面或者检查页面元素 # 例如前端应用可能会在Token有效后显示用户菜单 user_menu driver.find_element(css selector, .user-avatar) if user_menu.is_displayed(): print(通过Token免登录成功) else: print(Token注入可能未生效请检查Token和Key。) except Exception as e: print(f操作失败: {e}) driver.save_screenshot(token_error.png) finally: time.sleep(5) driver.quit()关键点与排查技巧确定存储的Key这是最大的难点。你需要查看目标网站的前端源代码F12 - Sources 或 直接看Network里加载的.js文件搜索localStorage.setItem或localStorage.getItem看它把Token存到了哪个键Key下。也可以直接在开发者工具的Application - Storage - Local Storage里查看登录成功后有哪些条目。Token格式确保你注入的Token字符串是完整的包括可能有的前缀如Bearer。通常前端存储的是纯Token字符串加Bearer前缀是在构造请求头时做的。页面刷新注入Token后必须刷新页面driver.refresh()。因为前端应用通常在页面加载初期就从LocalStorage读取Token并初始化用户状态。不刷新的话应用感知不到Token的变化。Token过期和Cookie一样Token也有有效期。你需要实现一个刷新机制或者在Token失效时有备用的自动登录方案。4.3 更复杂的场景使用Selenium Wire或Playwright如果网站的前端逻辑非常复杂或者Token并不是通过LocalStorage管理而是通过更隐秘的方式如内存变量、Service Worker单纯的JS注入可能无效。此外如果你想直接为所有发出的请求自动添加Authorization头就需要更强大的工具。Selenium Wire它是Selenium的一个扩展可以拦截和修改浏览器发出的所有请求。你可以给所有请求加上特定的Header。from seleniumwire import webdriver driver webdriver.Chrome() def interceptor(request): if request.url.startswith(https://api.target-website.com): request.headers[Authorization] fBearer {access_token} driver.request_interceptor interceptor driver.get(https://app.target-website.com)Playwright/Puppeteer这两个现代浏览器自动化框架在网络控制方面天生强大。以Playwright为例from playwright.sync_api import sync_playwright with sync_playwright() as p: browser p.chromium.launch(headlessFalse) context browser.new_context() # 为所有请求设置额外的HTTP头 context.set_extra_http_headers({Authorization: fBearer {access_token}}) page context.new_page() page.goto(https://app.target-website.com) # ... 后续操作这种方式最为彻底和可靠因为它是在网络层直接给请求加上了头完全模拟了一个已登录客户端的请求行为。5. 常见问题排查与安全实践在实际操作中你肯定会遇到各种各样的问题。下面是一个快速排查清单问题现象可能原因排查步骤与解决方案add_cookie()失败报错InvalidCookieDomainExceptionCookie的domain与当前浏览器页面域名不匹配。1. 确保在add_cookie前已通过driver.get()访问了目标域名的页面。2. 检查你构造的Cookie字典中domain字段的值。通常应该和浏览器地址栏的域名一致或者是以.开头的父域如.example.com匹配www.example.com和api.example.com。添加Cookie后刷新页面仍然未登录1. Cookie已过期。2. 缺少关键Cookie。3. 网站有额外的安全校验如IP绑定、User-Agent校验。1. 检查Cookie的expiry时间戳是否已过期。2. 使用driver.get_cookies()获取登录后的完整Cookie列表全部添加而不是只添加一个。有时维持会话需要多个Cookie协同工作。3. 尝试保持User-Agent一致。有些网站会校验会话与浏览器指纹的关联性。Token注入后刷新页面登录状态仍无效1. Token存储的Key不对。2. Token本身已过期或无效。3. 前端应用从其他地方读取Token如SessionStorage、IndexedDB。4. 前端有复杂的初始化逻辑需要更长的等待时间。1. 使用F12仔细检查前端实际使用的LocalStorage Key。2. 获取一个新的Token重试。3. 尝试同时注入SessionStoragesessionStorage.setItem(key, token)。4. 增加刷新后的等待时间或通过判断特定元素出现来确认应用已就绪。脚本在本地运行成功但在服务器/CI环境失败1. 服务器环境无图形界面Headless某些网站有反爬或检测。2. Cookie/Token在服务器环境已过期未及时更新。3. IP地址不同触发风控。1. 为Headless浏览器添加一些常见参数如--disable-blink-featuresAutomationControlled,--user-agent...来伪装成普通浏览器。2. 实现Cookie/Token的持久化存储和定期更新机制确保服务器上的脚本总能拿到有效的凭证。3. 考虑使用稳定的代理IP。网站有滑动验证码或点选验证码这是免登录方案的天敌。1.首选在获取Cookie/Token的环节采用半自动方案即手动完成一次带验证码的登录然后长期复用凭证。2.次选研究验证码接口尝试绕过难度高可能违法。3.下策接入第三方打码平台增加成本稳定性依赖外部服务。安全与最佳实践提醒敏感信息保护Cookie和Token就是你的“数字身份证”。绝对不要将包含有效Cookie/Token的脚本或配置文件上传到公开的Git仓库。使用.gitignore忽略cookies.json这类文件或者使用环境变量、加密的配置文件来存储这些敏感信息。遵守robots.txt与服务条款在实施任何自动化操作前请务必检查目标网站的robots.txt文件和服务条款。尊重网站规定避免对服务器造成过大压力。设置合理的等待与间隔即使免登录了在后续的自动化操作中如点击、翻页、提交数据也要加入随机延迟time.sleep(random.uniform(1, 3))模拟人类操作避免被识别为机器人。做好异常处理与日志记录脚本中必须有完善的try...except块对可能失败的操作如元素找不到、网络超时进行捕获和处理并记录详细的日志方便后期排查问题。定期维护免登录不是一劳永逸。建立定期运行“Cookie更新脚本”的机制如每周一次确保你的自动化任务始终有有效的凭证可用。免登录技术是提升Selenium自动化效率和稳定性的关键一步。理解Cookie和Token的原理熟练掌握其获取和注入方法并能根据不同的网站架构灵活选择方案是一个自动化工程师的必备技能。从简单的Cookie注入到复杂的Token头管理每一步都充满了细节和“坑”但一旦打通你的自动化脚本将真正获得解放能够7x24小时稳定可靠地运行。