Geckodriver中Actions操作引发JavaScript循环引用异常的分析与解决方案

Geckodriver中Actions操作引发JavaScript循环引用异常的分析与解决方案

geckodriver WebDriver for Firefox 项目地址: https://gitcode.com/gh_mirrors/ge/geckodriver

问题现象

在使用Selenium WebDriver配合Geckodriver进行自动化测试时，部分用户反馈在执行Actions操作（如点击、选择等）时会出现"JavaScriptException: Cyclic object value"异常。该问题主要出现在Firefox 135.0版本中，当使用最新版Geckodriver(v0.35)时表现尤为明显。

技术背景

这个问题源于Firefox 135.0版本中引入的一项改动：将浏览器首选项remote.events.async.enabled的默认值从false改为true。这个首选项控制着Marionette协议（Firefox的自动化协议）中事件处理的异步执行方式。

问题根源

通过分析trace级别的日志可以发现，当启用异步事件处理时，Geckodriver在序列化DOM元素到JSON时会遇到循环引用问题。具体表现为：

1. 当Actions操作涉及具体页面元素时（如context_click(element)），Marionette尝试序列化整个元素对象
2. 某些网站（特别是使用ServiceNow框架的页面）的DOM结构存在循环引用
3. JSON序列化过程无法处理这种循环引用，导致"Cyclic object value"异常

解决方案

目前有两种可行的解决方案：

临时解决方案

在代码中显式设置remote.events.async.enabled为false，回退到同步事件处理模式：

# Python示例
options = Options()
fp = webdriver.FirefoxProfile()
fp.set_preference("remote.events.async.enabled", False)
options.profile = fp
driver = webdriver.Firefox(options=options)

永久解决方案

Mozilla团队已经确认该问题为回归性bug，并将在Firefox 137版本中修复。对于急需使用的用户，可以：

1. 使用Firefox 134或更早版本
2. 等待Firefox 136/137正式发布
3. 使用每日构建的Nightly版本进行验证

最佳实践建议

1. 在自动化测试项目中固定Firefox和Geckodriver的版本组合
2. 对于关键业务场景，建议在CI/CD流程中加入版本兼容性测试
3. 遇到类似问题时，优先收集trace级别的日志进行分析

技术展望

这个问题反映了浏览器自动化测试中异步处理机制的复杂性。随着Web应用越来越复杂，自动化工具需要更好地处理各种边界情况。Mozilla团队表示未来会加强相关测试用例的覆盖，避免类似回归问题的发生。

geckodriver WebDriver for Firefox 项目地址: https://gitcode.com/gh_mirrors/ge/geckodriver