Selenium调用drag_and_drop_by_offset报AttributeError异常

问题场景 #

• 业务场景：基于Selenium实现Web自动化测试，使用页面对象模型（POM）封装签名页SignaturePage的签名设置方法setSignature
• 异常表现：调用ActionChains的drag_and_drop_by_offset方法时抛出属性错误，完整报错为AttributeError: move_to requires a WebElement
• 原有问题代码：

from selenium.webdriver.common.action_chains import ActionChains
class SignaturePage:
    signatureCanvas = "canvas_signature"
    btn_go_back = "//*[@id='mobile-wrapper']/main/section/a"
    btn_draw_signature = "//*[@id='mobile-wrapper']/main/article[1]/div[2]/div[1]/div[1]/a"
    canvas = "//*[@id='canvas_signature']"

    def __init__(self, driver):
        self.driver = driver

    def btngoBack(self):
        self.driver.find_element_by_xpath(self.btn_go_back).click()

    def btnDrawSignature(self):
        self.driver.find_element_by_xpath(self.btn_draw_signature).click()

    def setSignature(self):
        box = self.driver.find_elements_by_xpath(self.canvas)
        action = ActionChains(self.driver)
        action.drag_and_drop_by_offset(box, 200, 0)
        action.perform()

报错根因 #

• 核心错误：setSignature方法中使用find_elements_by_xpath定位canvas元素，该方法返回值是匹配到的WebElement列表，即使页面仅存在一个匹配的canvas节点，返回值也是长度为1的列表，而非单个WebElement对象。drag_and_drop_by_offset方法第一个参数要求传入单个WebElement实例，传入列表时会触发类型不匹配的报错。
• 兼容提示：Selenium 4.3及以上版本已经正式废弃find_element_by_*/find_elements_by_*系列旧定位API，直接调用会触发废弃警告，高版本下会直接抛出方法不存在的异常，建议替换为官方推荐的统一find_element定位写法。

修复后代码 #

from selenium.webdriver.common.action_chains import ActionChains
from selenium.webdriver.common.by import By

class SignaturePage:
    signatureCanvas = "canvas_signature"
    btn_go_back = "//*[@id='mobile-wrapper']/main/section/a"
    btn_draw_signature = "//*[@id='mobile-wrapper']/main/article[1]/div[2]/div[1]/div[1]/a"
    canvas = "//*[@id='canvas_signature']"

    def __init__(self, driver):
        self.driver = driver

    def btngoBack(self):
        # 替换旧API为新的统一find_element写法
        self.driver.find_element(By.XPATH, self.btn_go_back).click()

    def btnDrawSignature(self):
        self.driver.find_element(By.XPATH, self.btn_draw_signature).click()

    def setSignature(self):
        # 1. 用find_element（单数）获取单个WebElement对象，替换原来的find_elements（复数）
        # 2. 替换旧定位API，传入By类型指定定位方式
        box = self.driver.find_element(By.XPATH, self.canvas)
        action = ActionChains(self.driver)
        # 单段直线拖拽仅能绘制直线签名，若需要模拟真实手写签名，可以追加多段拖拽动作
        action.click_and_hold(box).move_by_offset(50, 20).move_by_offset(100, -30).move_by_offset(30, 40).release().perform()

额外说明 #

如果修复后仍然无法在canvas上生成有效签名，可以在执行拖拽动作前先调用一次action.click(box).perform()激活画布焦点，避免画布未获取焦点导致触控/鼠标事件不生效。

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