本文详解 selenium 中因定位策略与方法误用导致的 `invalidselectorexception` 异常，重点说明 `by.class_name` 与 `by.css_selector` 的本质区别，以及 `find_element()` 和 `find_elements()` 的关键差异，并提供可直接运行的修复示例。
在使用 Selenium 自动化操作网页时，一个常见错误是混淆定位器（locator）类型与选择器语法。例如，当尝试通过类似 .event-widget time 这样的 CSS 类选择器路径获取元素时，若错误地使用 By.CLASS_NAME，Selenium 将抛出 selenium.common.exceptions.InvalidSelectorException 异常——因为 By.CLASS_NAME 仅接受单一、不带点号（.）的类名字符串（如 "event-widget"），而不能解析复合 CSS 选择器。
正确的做法是：
✅ 使用 By.CSS_SELECTOR 配合标准 CSS 语法（支持 .class、#id、空格后代选择器等）；
✅ 若需匹配多个元素，必须调用 find_elements()（复数形式），返回 list[WebElement]；
❌ find_element()（单数）仅返回第一个匹配项（类型为 WebElement），无法用于 for 循环遍历。
以下是修复后的完整可执行代码（已适配现代 Selenium 4+ 写法，推荐使用 Service 类管理驱动）：
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options
# 推荐：使用 Service 显式指定 chromedriver 路径（避免弃用警告）
chrome_options = Options()
chrome_options.add_argument("--headless") # 可选：无头模式
service = Service("C:/development/chromedriver.exe") # 注意 Windows 路径使用正斜杠或双反斜杠
driver = webdriver.Chrome(service=service, options=chrome_options)
driver.get("https://python.org")
# ✅ 正确：CSS_SELECTOR + find_elements()
event_times = driver.find_elements(By.CSS_SELECTOR, ".event-widget time")
for elem in event_times:
print(elem.text)
driver.quit() # 始终记得关闭浏览器实例? 关键注意事项：
- By.CLASS_NAME("event-widget") 只能定位 class 属性包含 "event-widget" 的元素，无法表达“.event-widget 内部的 time 标签”这一层级关系；
- .event-widget time 是标准 CSS 后代选择器，必须搭配 By.CSS_SELECTOR；
- 若页面加载较慢，建议添加显式等待（如 WebDriverWait + expected_conditions.presence_of_all_elements_located），避免 NoSuchElementException；
- 路径字符串中反斜杠 \ 在 Python 字符串中是转义符，Windows 路径推荐写为 "C:/development/chromedriver.exe" 或 "C:\\development\\chromedriver.exe"。
掌握定位器类型与选择器语法的严格对应关系，是编写健壮 Selenium 脚本的基础。务必根据实际 HTML 结构选择合适的 By 策略，并始终确认方法名（element vs elements）与预期返回值一致。
立即学习“前端免费学习笔记（深入）”；
