Selenium 4.x 升级后，别再写 driver = webdriver.Chrome() 了！手把手教你三种正确写法
Selenium 4.x 升级后，别再写 driver = webdriver.Chrome() 了！手把手教你三种正确写法
最近在技术社区里，不少开发者都在讨论一个奇怪的报错：AttributeError: 'str' object has no attribute 'capabilities'。这个错误通常出现在升级到 Selenium 4.x 后，运行原本正常的脚本时突然崩溃。作为一个长期使用 Selenium 进行自动化测试的开发者，我也曾在这个问题上栽过跟头。今天，我们就来彻底解决这个问题，并深入理解 Selenium 4.x 带来的重大变更。
1. 为什么你的旧代码突然不工作了？
Selenium 4.x 对 WebDriver 的初始化方式进行了重大重构。在 3.x 版本中，webdriver.Chrome()这种写法是标准做法，但在 4.x 中，这种直接调用方式已经被标记为不推荐（deprecated），并将在未来版本中移除。
核心变化点：
- 移除了对直接传递可执行路径字符串的支持
- 引入了
Service对象来管理浏览器驱动生命周期 - 改进了驱动程序的自动发现机制
当你看到'str' object has no attribute 'capabilities'这个错误时，实际上是因为 Selenium 4.x 不再接受驱动路径作为字符串参数，而是期望一个Service对象。
2. 三种现代且正确的 WebDriver 初始化方式
2.1 使用 Service 对象（官方推荐）
这是 Selenium 4.x 官方推荐的标准写法，提供了最大的灵活性和控制力：
from selenium.webdriver.chrome.service import Service as ChromeService from selenium import webdriver # 创建 Service 对象，指定 ChromeDriver 路径 service = ChromeService(executable_path='/path/to/chromedriver') # 初始化 WebDriver driver = webdriver.Chrome(service=service) # 使用完毕后记得关闭 driver.quit()优势：
- 明确指定驱动路径，避免环境依赖
- 可以精细控制驱动启动参数
- 代码意图清晰，易于维护
2.2 结合 WebDriver Manager（最省心）
如果你不想手动管理浏览器驱动版本，可以使用webdriver-manager这个神器：
from selenium.webdriver.chrome.service import Service as ChromeService from selenium import webdriver from webdriver_manager.chrome import ChromeDriverManager # 自动下载并管理合适版本的 ChromeDriver service = ChromeService(ChromeDriverManager().install()) # 初始化 WebDriver driver = webdriver.Chrome(service=service) # 常规操作... driver.get("https://www.example.com")为什么推荐：
- 自动处理驱动版本兼容性问题
- 无需手动下载和配置驱动
- 特别适合 CI/CD 环境
提示：首次运行时会下载对应驱动，可能会稍慢，后续运行会直接使用缓存。
2.3 依赖环境变量（最简洁）
如果你已经将 ChromeDriver 所在目录添加到系统 PATH 中，可以使用最简写法：
from selenium import webdriver driver = webdriver.Chrome() # 自动查找 PATH 中的驱动 driver.get("https://www.example.com")适用场景：
- 快速原型开发
- 个人学习环境
- 驱动路径已经全局配置好的情况
3. 深入理解 Service 对象
Selenium 4.x 引入的 Service 对象不仅仅是一个语法糖，它带来了更多控制能力：
Service 对象的可配置参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| executable_path | str | 驱动可执行文件路径 |
| port | int | 服务监听端口 |
| service_args | List[str] | 传递给驱动的额外参数 |
| log_path | str | 日志输出路径 |
| env | dict | 环境变量 |
高级用法示例：
service = ChromeService( executable_path='/path/to/chromedriver', port=9515, # 自定义端口 service_args=['--verbose'], # 开启详细日志 log_path='chromedriver.log' # 日志输出到文件 ) driver = webdriver.Chrome(service=service)4. 常见问题与解决方案
4.1 版本兼容性矩阵
不同浏览器和驱动版本需要匹配才能正常工作：
| 浏览器版本 | 推荐 ChromeDriver 版本 | 最低 Selenium 版本 |
|---|---|---|
| Chrome 115+ | 115.x | 4.10+ |
| Chrome 100-114 | 对应主版本号 | 4.0+ |
| Chrome 90-99 | 90.0.4430.24+ | 3.141+ |
4.2 错误排查清单
遇到问题时，可以按照以下步骤检查：
检查版本匹配：
chrome --version chromedriver --version pip show selenium验证驱动可执行权限：
chmod +x /path/to/chromedriver尝试显式指定路径：
service = ChromeService(executable_path='/绝对路径/chromedriver')查看详细日志：
service = ChromeService(log_path='chromedriver.log')
4.3 性能优化技巧
- 复用 Service 对象：在测试套件中共享同一个 Service 实例
- 合理设置超时：
from selenium.webdriver.common.options import ArgOptions options = ArgOptions() options.page_load_strategy = 'eager' # 不等待完整加载 driver = webdriver.Chrome(service=service, options=options) - 启用无头模式：
options.add_argument('--headless=new')
5. 迁移策略与最佳实践
对于大型项目，建议采用渐进式迁移：
创建适配层：
def create_driver(browser='chrome'): if browser == 'chrome': from selenium.webdriver.chrome.service import Service as ChromeService service = ChromeService(executable_path=get_chromedriver_path()) return webdriver.Chrome(service=service) # 其他浏览器支持...统一配置管理：
DRIVER_CONFIG = { 'chrome': { 'service_class': 'selenium.webdriver.chrome.service.Service', 'executable_path': '/path/to/chromedriver' } }自动化测试验证：
- 为新旧写法添加对比测试
- 监控驱动初始化性能
- 验证跨版本兼容性
在实际项目中，我发现结合 WebDriver Manager 的方案最能减少维护成本，特别是在团队协作和持续集成环境中。不过对于性能敏感的场景，显式指定 Service 对象的方式提供了更精细的控制能力。