Selenium 4.10+ 浏览器启动失败的常见原因与解决方案

轻萱酱_2124

轻萱酱_2124

2026-11-19

416人浏览

原创

Selenium 4.10+ 浏览器启动失败的常见原因与解决方案

本文详解 Selenium 升级至 4.10+ 后因弃用手动驱动管理、版本不匹配等问题导致 webdriver.Chrome() 启动失败的典型场景,并提供精简可靠的新版初始化方案及排错方法。

本文详解 selenium 升级至 4.10+ 后因弃用手动驱动管理、版本不匹配等问题导致 `webdriver.chrome()` 启动失败的典型场景,并提供精简可靠的新版初始化方案及排错方法。

随着 Selenium 4.10 版本的发布,其内置了自动化的浏览器驱动管理工具 —— selenium-manager,正式取代了开发者手动下载、指定 chromedriver.exe 路径的做法。若你仍沿用旧代码显式传入 Service(executable_path=...),在新版中极易触发 WebDriverException、SessionNotCreatedException 或静默卡死等异常,尤其当 Chrome 浏览器与驱动版本不一致时,问题会进一步加剧。

✅ 推荐做法:完全移除手动 Service 配置(Selenium ≥ 4.10)

新版 Selenium 可自动下载、缓存并匹配兼容的 ChromeDriver,只需确保系统已安装 Chrome 浏览器(v115+),且 chromedriver 不再需要手动维护:

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

options = Options()
# 可选:无头模式或禁用自动化提示(提升稳定性)
# options.add_argument("--headless")
# options.add_argument("--disable-blink-features=AutomationControlled")

driver = webdriver.Chrome(options=options)  # ✅ 无需 Service 参数
driver.get("https://www.google.com")
print("✅ 页面加载成功,当前标题:", driver.title)
driver.quit()

? 提示:首次运行会自动触发 selenium-manager 下载适配的驱动(需联网),后续复用本地缓存,无需重复操作。

浏览器会话(免费版)
浏览器会话(免费版)

浏览器会话管理免费版,支持一次性页面抓取、基础会话列表与简易调试。

下载

⚠️ 常见问题排查清单

问题现象 可能原因 解决方案
SessionNotCreatedException: session not created: This version of ChromeDriver only supports Chrome version XX Chrome 与 chromedriver 版本严重不匹配 访问 chrome://settings/help 查看 Chrome 版本;卸载旧 chromedriver.exe,彻底删除手动 Service 配置,改用自动管理
报错 Unable to find a matching set of capabilities 或空白页无响应 启用了过时的反检测参数(如 excludeSwitches=["enable-automation"]) 新版建议移除或改用更稳妥的绕过方式(如 options.add_experimental_option("useAutomationExtension", False))
控制台输出大量 DevTools listening on ... 但脚本卡住 Chrome 启动被安全软件拦截或端口冲突 添加 options.add_argument("--no-sandbox") 和 options.add_argument("--disable-dev-shm-usage")(仅限 Linux/CI 环境)

? 进阶调试建议

启用详细日志有助于定位底层问题:

import logging
from selenium import webdriver
from selenium.webdriver.chrome.options import Options

logging.basicConfig(level=logging.INFO)
options = Options()
options.set_capability("goog:loggingPrefs", {"browser": "ALL"})  # 启用浏览器日志

driver = webdriver.Chrome(options=options)
driver.get("https://www.google.com")

# 打印 JavaScript 控制台错误(如有)
for entry in driver.get_log("browser"):
    if entry["level"] == "SEVERE":
        print("⚠️ 浏览器错误日志:", entry)

driver.quit()

✅ 总结

  • 不再需要手动下载和指定 chromedriver 路径 —— Selenium 4.10+ 的 selenium-manager 已接管全部驱动生命周期;
  • 务必统一 Chrome 浏览器版本(推荐稳定版最新 Release),避免版本错位;
  • 若必须保留自定义驱动路径(如离线环境),请确保 chromedriver --version 输出与 chrome://settings/help 显示的 Chrome 主版本号严格一致(如 Chrome 128.x → 需 chromedriver 128.x);
  • 旧项目迁移时,优先删除 Service 实例和 executable_path 参数,再逐步验证功能。

遵循以上方案,90% 以上的“升级后无法启动浏览器”问题可快速解决。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

浏览器

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
软件测试常用工具
软件测试常用工具

软件测试常用工具有Selenium、JUnit、Appium、JMeter、LoadRunner、Postman、TestNG、LoadUI、SoapUI、Cucumber和Robot Framework等等。测试人员可以根据具体的测试需求和技术栈选择适合的工具,提高测试效率和准确性 。

2023.10.13

5390

8

java测试工具有哪些
java测试工具有哪些

java测试工具有JUnit、TestNG、Mockito、Selenium、Apache JMeter和Cucumber。php还给大家带来了java有关的教程,欢迎大家前来学习阅读,希望对大家能有所帮助。

2023.10.23

3781

10

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

20

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

20

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

20

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

20

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

20

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

20

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

180

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MDN CSS 文档与布局指南
MDN CSS 文档与布局指南

共0课时 | 0人学习

Postman安装指南
Postman安装指南

共0课时 | 0人学习