SeleniumBase项目中UC模式坐标计算问题的修复解析

在SeleniumBase自动化测试框架的4.29.8版本中，开发团队修复了一个关于UC模式（Undetected Chrome模式）下坐标计算的重要问题。这个问题会影响Windows系统上非100%缩放比例时的验证码点击操作准确性。

问题背景

UC模式是SeleniumBase提供的一种特殊运行模式，主要用于处理需要绕过检测的场景，比如验证码点击等操作。在该模式下，框架需要通过计算屏幕坐标来模拟用户点击行为。

当用户在Windows系统中设置了非100%的显示缩放比例（如125%或150%）时，原有的坐标计算逻辑会出现偏差。这是因为系统缩放会改变实际像素与逻辑坐标之间的映射关系，而原有代码没有考虑这一比例因素。

技术细节

问题的核心在于uc_gui_click_captcha()和uc_gui_click_cf()这两个方法的坐标计算逻辑中缺少了width_ratio（宽度比例）参数的应用。这个参数对于正确计算缩放后的实际点击位置至关重要。

在修复前，代码直接使用了原始坐标值而没有考虑系统缩放，导致：

1. 点击位置偏移
2. 验证码识别失败
3. 自动化流程中断

解决方案

开发团队在4.29.8版本中通过以下方式解决了这个问题：

1. 在坐标计算中引入width_ratio参数
2. 根据系统缩放比例调整实际点击坐标
3. 确保在不同缩放设置下都能准确定位目标元素

影响范围

该修复主要影响以下使用场景：

• 在Windows系统上运行测试
• 系统显示缩放比例不是100%
• 使用UC模式处理验证码或类似需要精确定位的操作

最佳实践

对于使用SeleniumBase框架的开发者，建议：

1. 及时升级到4.29.8或更高版本
2. 在涉及坐标操作时考虑系统缩放因素
3. 在不同缩放设置的测试环境中验证关键操作

这个修复体现了SeleniumBase团队对跨平台兼容性的重视，也展示了框架持续改进的承诺。对于依赖验证码处理的自动化测试场景，这一改进将显著提高测试的稳定性和可靠性。