Selenium 測試失敗排查：一次元素定位超時的完整解決之旅

在自動化測試過程中，我們經常會遇到元素定位超時的問題。本文記錄了一次完整的 Selenium TimeoutException 排查過程，從問題發現到最終解決，涵蓋了各種常見陷阱和解決方案。

問題背景

測試用例在執行過程中失敗，具體錯誤信息如下：

selenium.common.exceptions.TimeoutException: Message:
在 product_detail_page.py 第 36 行執行 wait_until_visibility 時，
等待了 10 秒仍未找到指定的元素

問題排查思維導圖