SeleniumBase项目中Headless UC模式的User-Agent字符串问题解析

在SeleniumBase项目的4.23.7版本中，修复了一个关于Headless UC模式下User-Agent字符串的重要问题。这个问题影响了用户在使用无头浏览器模式时的识别特征，可能导致某些网站检测到自动化浏览行为。

问题背景

User-Agent字符串是浏览器向网站服务器标识自身身份的重要信息。在自动化测试中，保持User-Agent字符串与常规浏览器一致是避免被检测的关键因素之一。

SeleniumBase项目提供了UC(Undetected Chrome)模式，旨在模拟常规Chrome浏览器的行为，包括User-Agent字符串的格式。然而，在Chrome 120版本发布后，Headless UC模式的User-Agent字符串出现了与常规Chrome不一致的情况。

问题表现

在Chrome 121.0.6167.184版本中，不同模式下的User-Agent字符串表现如下：

1. 常规Chrome：

   Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36
   

2. Headless Chrome(非UC模式)：

   Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/121.0.6167.184 Safari/537.36
   

3. Headless Chrome(UC模式)：

   Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.6167.184 Safari/537.36
   

4. 期望的Headless Chrome(UC模式)：

   Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36
   

问题分析

关键差异在于Chrome版本号的表示方式：

• 常规Chrome使用主版本号格式(121.0.0.0)
• Headless UC模式错误地使用了完整版本号(121.0.6167.184)

这种差异虽然看似微小，但对于某些网站的检测机制来说，完整版本号的出现在无头模式下可能成为识别自动化浏览器的标志。这也是为什么一些用户在使用Headless UC模式时会遇到网站检测问题的原因。

解决方案

SeleniumBase团队在4.23.7版本中修复了这个问题，确保Headless UC模式的User-Agent字符串与常规Chrome完全一致，包括版本号的格式。具体修改包括：

1. 将HeadlessChrome替换为Chrome
2. 将完整版本号(121.0.6167.184)替换为主版本号格式(121.0.0.0)

这一修复使得Headless UC模式能够更好地模拟常规浏览器的行为，提高了自动化测试的识别特征和成功率。

技术建议

对于自动化测试开发者，建议：

1. 定期检查User-Agent字符串是否与目标浏览器一致
2. 关注SeleniumBase的更新，及时升级到最新版本
3. 在Linux环境下，可以考虑使用xvfb配合headed模式作为临时解决方案
4. 对于特别敏感的网站，可以自定义User-Agent字符串以确保一致性

通过保持User-Agent字符串与常规浏览器完全一致，可以显著降低被网站检测到自动化行为的风险，提高测试的稳定性和可靠性。