shadow dom 通过隔离作用域制造路径引用问题，定位内部元素必须显式逐层调用 .shadowroot，closed mode 下无法访问，仅 open mode 支持穿透查询。
Shadow DOM 本身不解决路径引用问题，它制造了路径引用问题
Shadow DOM 不是用来“解决”路径引用的，而是把原本扁平的 DOM 树切成多层隔离结构。你写的 document.querySelector("button") 在主文档里查不到 shadow 内部的 button，不是因为路径写错了，是因为根本不在同一个作用域里。所谓“路径引用问题”，其实是作用域断裂——不是路径不对，是路径没资格跨过去。
定位 shadow 内元素必须手动穿透，没有自动路径解析
浏览器不支持像 css-selector 那样直接写 custom-modal::shadow button（该语法早已废弃），也不接受 XPath 穿透 shadow-root。所有有效路径都得显式拼接 .shadowRoot 调用链。常见错误包括：
- 复制 Chrome 的 “Copy JS Path” 后直接粘贴进
execute_script，但忘了加return前缀，导致返回undefined - 路径中嵌套单双引号没转义，比如
'document.querySelector("x-app").shadowRoot.querySelector('button')少了一个反斜杠，Python 字符串直接报错 - 没等 shadow root 挂载完就执行查询，
shadowRoot属性为null，JS 报Cannot read property 'querySelector' of null
正确做法是分步查：先确认宿主存在 → 等待其 shadowRoot 非空 → 再查内部元素。不能指望一条选择器通到底。
多层 shadow DOM 要逐层调用 .shadowRoot，不能跳步
像 Reddit 登录流程那种嵌套结构：shreddit-app → shreddit-overlay-display → … → button，必须严格按层级顺序调用 .shadowRoot.querySelector()。少一层或顺序错，中间某步返回 null，后续全崩。
示例中这段路径：
document.querySelector("shreddit-app").shadowRoot.querySelector("shreddit-overlay-display").shadowRoot.querySelector("shreddit-signup-drawer").shadowRoot.querySelector("shreddit-drawer").shadowRoot.querySelector("div").querySelector("shreddit-async-loader").shadowRoot.querySelector("div")
每一处 .shadowRoot 都对应一个真实挂载点，漏掉任意一个，就卡在上一级宿主里出不去。这不是路径写法技巧问题，是 DOM 结构强制要求的访问协议。
closed mode 下无解，open mode 才有路可走
如果组件用了 attachShadow({ mode: 'closed' })，.shadowRoot 属性永远是 null，任何 JS 路径都会失败。此时 Selenium 完全无法访问内部元素，连调试都做不到。唯一可行路径是：
- 推动前端改用
mode: 'open'（最治本） - 退而求其次，让开发暴露一个对外方法，如
component.getInternalButton()，再用execute_script调用 - 放弃精准定位，改用坐标点击或页面级事件模拟（极不可靠，仅应急）
别试图用 MutationObserver 监听 closed shadow 内部变化——你连 root 都拿不到，observer 无处 attach。
