TikTok-Api 中 EmptyResponseException 问题的分析与解决

问题背景

在使用 TikTok-Api 进行开发时，许多开发者遇到了一个常见问题：当尝试通过 hashtag 获取视频列表时，系统会抛出 EmptyResponseException 异常，提示"TikTok returned an empty response"。这个问题在 macOS 14.4.1 系统上使用 TikTokApi 6.3.0 版本时尤为常见。

问题现象

开发者尝试运行以下代码获取特定标签（如"brainrot"）下的视频列表：

from TikTokApi import TikTokApi
import asyncio

ms_token = "your_ms_token_here"

async def get_hashtag_videos():
    async with TikTokApi() as api:
        await api.create_sessions(ms_tokens=[ms_token], num_sessions=1, sleep_after=3)
        tag = api.hashtag(name="brainrot")
        async for video in tag.videos(count=30):
            print(video)
            print(video.as_dict)

if __name__ == "__main__":
    asyncio.run(get_hashtag_videos())

然而，代码执行时会抛出 EmptyResponseException 异常，表示 TikTok 返回了空响应。

问题原因分析

经过深入分析，这个问题主要与 TikTok 的反爬虫机制有关。TikTok 会对自动化请求进行检测，当检测到可疑行为时，可能会返回空响应或采取其他限制措施。

具体来说，当使用默认配置创建会话时（headless=True），TikTok 更容易识别出自动化请求并返回空响应。这是因为 headless 模式下浏览器的一些特征更容易被检测到。

解决方案

解决这个问题的关键在于修改会话创建方式，使其更接近真实用户行为。具体解决方案如下：

await api.create_sessions(
    ms_tokens=[ms_token],
    num_sessions=1,
    sleep_after=3,
    headless=False  # 关键修改点
)

将 headless 参数设置为 False 后，浏览器会以可见模式运行，这使得请求看起来更像来自真实用户，从而降低了被 TikTok 识别为自动化请求的风险。

深入理解

1. headless 模式：headless 浏览器是没有图形用户界面的浏览器，通常用于自动化测试和爬虫。虽然效率高，但容易被网站检测到。

2. TikTok 的反爬机制：TikTok 采用了多种技术来检测自动化请求，包括检测浏览器指纹、行为模式等。headless 模式下的某些特征（如缺少常见插件、特定用户代理等）容易被识别。

3. 会话管理：create_sessions 方法负责创建与 TikTok 交互的会话，headless=False 使得会话更接近真实用户环境。

最佳实践建议

1. 合理设置请求间隔：即使使用 headless=False，也应设置合理的 sleep_after 值，模拟人类操作间隔。

2. 多会话管理：可以考虑创建多个会话轮流使用，避免单一会话请求过于频繁。

3. 错误处理：代码中应添加适当的异常处理机制，应对可能出现的各种限制情况。

4. 环境模拟：进一步可以设置更真实的浏览器环境，如添加常见插件、设置合理的视窗大小等。

总结

通过将 create_sessions 方法的 headless 参数设置为 False，可以有效解决 TikTok-Api 中出现的 EmptyResponseException 问题。这一修改使得自动化请求更接近真实用户行为，降低了被 TikTok 反爬机制识别的风险。开发者在使用 TikTok-Api 时，应当充分理解目标平台的反爬策略，并采取相应措施确保请求的成功率。