本文详解如何在 SeleniumBase 中启用并正确使用 response_interceptor 实现实时 HTTP 响应拦截，解决因未及时读取 driver.requests 导致请求遗漏的问题，并提供可立即运行的代码示例与关键注意事项。
本文详解如何在 seleniumbase 中启用并正确使用 `response_interceptor` 实现实时 http 响应拦截，解决因未及时读取 `driver.requests` 导致请求遗漏的问题，并提供可立即运行的代码示例与关键注意事项。
SeleniumBase 自 4.18.0 版本起原生集成了 selenium-wire 的能力（需启用 wire=True），支持对 HTTP 请求与响应进行细粒度拦截和修改。但需注意：driver.requests 是静态快照——它仅在调用时刻保存已发生的请求列表，而页面加载过程中大量异步请求（如 LinkedIn 的资源加载、API 调用、埋点上报等）可能在 driver.get() 返回后仍持续发出，若未在请求发生时实时捕获，就会被遗漏。
真正的实时拦截必须依赖 response_interceptor（或 request_interceptor）回调函数，该函数会在每个响应返回瞬间被触发，确保无一遗漏。
✅ 正确用法：使用 response_interceptor 实现实时拦截
以下是最小可行示例，适用于 Chrome/Firefox：
from seleniumbase import Driver
def intercept_response(request, response):
# request: seleniumwire.request.Request 对象
# response: seleniumwire.response.Response 对象（可能为 None，如请求失败）
if response:
print(f"[{response.status}] {request.method} {request.url}")
print("Headers:", dict(request.headers))
# 启用 wire 模式是前提！否则 interceptor 不生效
driver = Driver(browser="chrome", wire=True, headed=True)
driver.response_interceptor = intercept_response
try:
driver.get("https://www.linkedin.com")
# 建议添加显式等待，确保动态资源充分加载（如 React 组件、XHR）
driver.sleep(5) # 或使用 driver.wait_for_element_visible()
finally:
driver.quit()? 提示：intercept_response 函数签名必须严格为 (request, response)，且需在 driver.get() 之前赋值给 driver.response_interceptor。赋值时机错误将导致拦截器静默失效。
⚠️ 关键注意事项
- wire=True 必不可少：这是启用 selenium-wire 功能的开关。未设置时，driver.response_interceptor 赋值无效，且 driver.requests 为空或仅含初始导航请求。
-
不要依赖 driver.requests 做实时分析：该属性只反映调用时刻的历史请求快照，适合事后审计，不适合监听流式流量。例如：
driver.get("https://example.com") print(len(driver.requests)) # 可能只有 1~2 个（HTML + favicon） driver.sleep(3) print(len(driver.requests)) # 此时才可能包含 JS/CSS/XHR 等后续请求 - 处理空响应：某些请求（如 prefetch、ping、CORS 预检失败）可能无 response 对象，务必判空再访问 response.status 等属性，避免 AttributeError。
- 性能影响：拦截器在主线程同步执行，复杂逻辑（如写文件、网络调用）会阻塞浏览器渲染。生产环境建议仅记录关键字段，或异步提交日志。
- HTTPS 与证书：首次运行可能提示证书警告（因 selenium-wire 使用自签名 CA）。SeleniumBase 默认自动信任，无需手动配置；如遇连接问题，可添加 certutil=False 参数临时跳过证书校验（不推荐用于安全测试）。
? 进阶技巧：请求过滤与响应篡改
你还可以结合 request_interceptor 修改请求头、重写 URL，或在 response_interceptor 中篡改响应内容（例如 mock API 返回）：
def request_interceptor(request):
if "api.linkedin.com" in request.url:
request.headers["X-Mock-Mode"] = "true"
def response_interceptor(request, response):
if response and "api/v2/me" in request.url:
# 模拟返回精简用户数据（需确保 Content-Length 一致或移除）
response.body = b'{"firstName":"Test","lastName":"User"}'
response.headers["Content-Length"] = str(len(response.body))
driver.request_interceptor = request_interceptor
driver.response_interceptor = response_interceptor⚠️ 响应篡改需谨慎：修改 response.body 后，应同步更新 Content-Length 头，否则前端解析可能失败。
掌握 response_interceptor 是实现自动化测试中网络层可观测性、接口契约验证及 Mock 测试的核心能力。务必以 wire=True 启动驱动，并始终优先使用回调机制而非轮询 driver.requests——这才是 SeleniumBase 中 HTTP 拦截的正确打开方式。
