Python Selenium抓取Microsoft Teams作业列表时TimeoutException问题

核心原因排查与修复方案 #

你遇到的超时、页面内容不符合预期，基本是以下几个常见原因导致，按优先级逐一排查修复即可：

• 登录后未进入作业列表页
  你当前填写的<link to teams webpage>如果是Teams首页，登录后默认进入聊天/团队主页，不会直接加载作业模块，自然找不到对应元素。建议直接替换为作业列表的直链，或者登录完成后模拟点击作业入口跳转至对应页面。
• 未切换到iframe上下文
  Teams Web端的作业模块是嵌套在独立iframe中加载的，默认在顶层DOM查找元素必然返回空。先定位到作业模块对应的iframe，切换上下文后再查找元素：

  # 切换到作业模块iframe，可根据src、id等属性精准定位
  WebDriverWait(browser, 20).until(
      EC.frame_to_be_available_and_switch_to_it(
          (By.XPATH, '//iframe[contains(@src, "assignments")]')
      )
  )
  # 作业元素查找逻辑写在切换iframe之后
  

  操作完iframe内元素后可以调用browser.switch_to.default_content()切回顶层DOM。
• 元素被封装在Shadow DOM中
  微软产品大量使用Shadow DOM做组件隔离，普通DOM查找方法无法穿透Shadow Root。如果开发者工具中你要找的元素路径包含#shadow-root标记，需要用以下方式查找：

  # 先定位Shadow Host节点
  shadow_host = WebDriverWait(browser, 20).until(
      EC.presence_of_element_located((By.CSS_SELECTOR, '对应Shadow Host的选择器'))
  )
  shadow_root = shadow_host.shadow_root
  # 从Shadow Root下查找目标元素
  assignments = shadow_root.find_elements(By.XPATH, '//*[@id="list-view-current-day"]/div/div')
  

• 使用了不稳定的定位方式和废弃API
  你当前用的绝对路径XPath抗干扰性极差，页面结构稍有变动就会失效，建议替换为基于元素文本、class、业务属性的相对定位。同时Selenium 4.0+已经废弃了find_element_by_id/find_elements_by_xpath等方法，需要替换为统一API：

  # 旧写法
  # username = browser.find_element_by_id('i0116')
  # 新写法
  username = browser.find_element(By.ID, 'i0116')
  

调试排查技巧 #

如果按上面修改后还是有问题，先加一行代码保存当前页面源码，确认Selenium实际拿到的页面内容：

with open('teams_debug.html', 'w', encoding='utf-8') as f:
    f.write(browser.page_source)

打开保存的teams_debug.html即可快速判断是登录失败、跳转错误、还是元素上下文没切换的问题。

内容的提问来源于stack exchange，提问作者Hello-World