Selenium Python访问TikTok页面元素报NoSuchElementException异常

问题现象 #

使用Python版Selenium开展Web自动化操作时，访问TikTok搜索结果页（地址：https://www.tiktok.com/search?q=funny%20dog%20videos），仅能成功定位到ID为app的顶层根元素，尝试定位页面内其他元素时均抛出NoSuchElementException异常。经排查确认页面无iframe嵌套，浏览器驱动仅持有1个窗口句柄，未定位到元素访问受阻的直接原因。

问题复现代码 #

from selenium.webdriver.chrome.options import Options
from selenium.webdriver.common.by import By
from selenium.webdriver import ActionChains
from webdriver_manager.chrome import ChromeDriverManager
from selenium import webdriver

options  = Options()
options.add_argument("--disable-notifications")
options.add_experimental_option("prefs", {"download.default_directory" : r"C:\Users\jack_l\Downloads\TESTING TIKTOK"})

driver = webdriver.Chrome(ChromeDriverManager().install(), chrome_options=options)
driver.maximize_window()
driver.get('https://www.tiktok.com/search?q=funny dog videos')

action = ActionChains(driver)

driver.find_element(By.ID, 'app') # 定位成功
driver.find_element(By.CLASS_NAME, 'tiktok-12azhi0-DivHeaderContainer e10win0d0') # 定位报错

诱发原因 #

问题由3个核心问题共同导致：

• By.CLASS_NAME定位方式不支持传入带空格的类名字符串。类名中的空格代表元素同时持有多个独立class值，tiktok-12azhi0-DivHeaderContainer e10win0d0实际是两个独立类名，直接传入会被Selenium当作单个完整类名匹配，必然匹配失败。
• 未设置元素等待逻辑。TikTok是单页React应用，app是页面初始加载时就存在的根节点，执行driver.get()后页面内部的业务组件（头部容器、视频列表等）是异步渲染的，代码执行到定位语句时目标元素还未挂载到DOM树，自然无法找到。
• TikTok的前端类名包含构建生成的动态哈希段，代码里写的tiktok-12azhi0-前缀部分会随版本迭代、页面部署动态变化，硬编码完整类名的定位方式稳定性极差。另外默认启动的Selenium特征明显，会被TikTok的反爬机制识别，可能导致页面内容不完全渲染。

修复方案 #

• 替换错误的类名定位逻辑：不要用By.CLASS_NAME匹配多类名元素，改用By.CSS_SELECTOR定位，优先匹配类名中稳定的业务标识段（比如DivHeaderContainer、e10win0d0这类非哈希值），避开动态变化的哈希前缀。
• 移除硬编码即时查找的逻辑，改用显式等待，等待目标元素渲染完成、可交互后再执行定位操作，不要依赖固定时长的time.sleep()。
• 补充基础的Selenium反检测配置，绕过TikTok的自动化工具识别，保证页面正常渲染所有内容。

修复后参考代码 #

from selenium.webdriver.chrome.options import Options
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver import ActionChains
from webdriver_manager.chrome import ChromeDriverManager
from selenium import webdriver

options  = Options()
options.add_argument("--disable-notifications")
options.add_argument("--disable-blink-features=AutomationControlled")
options.add_experimental_option("prefs", {"download.default_directory" : r"C:\Users\jack_l\Downloads\TESTING TIKTOK"})
options.add_experimental_option("excludeSwitches", ["enable-automation"])
options.add_experimental_option("useAutomationExtension", False)

# 新版本Selenium不再支持chrome_options参数，统一使用options传参
driver = webdriver.Chrome(ChromeDriverManager().install(), options=options)
driver.maximize_window()
# 注入脚本移除navigator.webdriver特征
driver.execute_cdp_cmd("Page.addScriptToEvaluateOnNewDocument", {
    "source": "Object.defineProperty(navigator, 'webdriver', {get: () => undefined})"
})
driver.get('https://www.tiktok.com/search?q=funny dog videos')

action = ActionChains(driver)
wait = WebDriverWait(driver, 15)

# 定位顶层app元素
app = driver.find_element(By.ID, 'app')
# 等待头部容器加载完成，用CSS选择器匹配稳定类名
header_container = wait.until(EC.presence_of_element_located(
    (By.CSS_SELECTOR, 'div[class*="DivHeaderContainer"]')
))

注：如果定位其他业务元素，优先用元素的角色、固定属性、文本内容定位，不要依赖TikTok动态生成的哈希类名，能大幅提升定位稳定性。

内容的提问来源于stack exchange，提问作者THEMOUNTAINSANDTHESKIES