Selenium 的 @FindBy(className = "...") 不支持多个空格分隔的类名；遇到 InvalidSelectorException: Compound class names not permitted 错误时，应改用 CSS 选择器（如 .class1.class2.class3）精准定位含多类元素。
selenium 的 `@findby(classname = "...")` 不支持多个空格分隔的类名；遇到 `invalidselectorexception: compound class names not permitted` 错误时，应改用 css 选择器（如 `.class1.class2.class3`）精准定位含多类元素。
在使用 Selenium PageFactory 和 Fluent API 进行页面对象建模时，一个常见但容易被忽视的陷阱是：@FindBy(className = "...") 注解仅接受单个类名。当你传入类似 "action submit primary" 这样的字符串（含空格），Selenium 会将其视为“复合类名”，从而抛出 org.openqa.selenium.InvalidSelectorException: Compound class names not permitted 异常——即使该字符串准确反映了 HTML 元素的 class 属性值。
例如，目标按钮 HTML 可能如下：
<button type="submit" class="action submit primary">Create an Account</button>
其中 action、submit、primary 是三个独立的 CSS 类，共同构成语义化样式组合。此时若错误地写作：
@FindBy(className = "action submit primary") // ❌ 错误：空格分隔 → 触发异常 private WebElement createAccountButton;
就会立即失败。
✅ 正确做法是切换为 CSS 选择器，利用类选择器链（. 连接多个类）实现精确匹配：
@FindBy(css = ".action.submit.primary") // ✅ 正确：等价于 class="action submit primary" private WebElement createAccountButton;
该写法语义清晰、兼容性强，且无需依赖元素顺序（CSS 类顺序在 HTML 中可变，但 .a.b.c 选择器不敏感于顺序）。
⚠️ 补充注意事项：
- @FindBy(xpath = "//*[@class='action submit primary']") 虽语法合法，但不推荐：@class 属性值必须完全匹配（包括空格和顺序），容错性差，且易受前端动态类名（如 BEM 或 JS 添加/移除类）影响；
- 若仅需其中一个类即可唯一标识（如 .action 已足够），可简化选择器以提升健壮性；
- 在现代 Selenium（v4+）中，PageFactory 已被标记为过时（deprecated），建议逐步迁移至 PageFactory 替代方案（如构造函数注入 + WebElement 显式查找，或使用 @CacheLookup + WebDriverWait 增强稳定性）。
综上，面对复合类名定位需求，请始终优先选用 @FindBy(css = "...")，它既符合 W3C 标准，又具备良好的可读性、灵活性与维护性。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
