告别硬编码！5个让Web自动化脚本更稳定的定位策略

导语： 如果你做过Web自动化测试，一定对这样的场景不陌生：昨晚还跑得好好的脚本，今天一早突然报错NoSuchElementException（找不到元素）。你火急火燎地打开调试器，发现前端同事只是把某个按钮的id从submit-btn改成了confirm-btn，而你脚本中所有相关的操作瞬间瘫痪。这就是“硬编码”定位策略的代价——脆弱、耦合、维护成本极高。今天，我们将彻底告别这种被动局面，通过5种高级定位策略，打造出真正稳定、健壮、可维护的自动化脚本。

一、 为什么你的定位策略如此“脆弱”？硬编码的原罪

在深入解决方案之前，我们必须认清问题的根源。所谓“硬编码”，在元素定位中通常指：

1. 过度依赖绝对路径： 使用长得令人发指的XPath，如 /html/body/div[3]/div[2]/div/div[1]/form/div[1]/input。页面结构稍有变动，路径立即失效。

2. 迷信单一且易变的属性： 将整个脚本的成败押注在id、class等可能因前端重构、样式调整或动态生成而改变的属性上。

3. 缺乏容错与自适应机制： 定位策略是“非黑即白”的，要么找到，要么报错，没有给页面元素的动态变化留出任何余地。

这种写法的本质是将测试脚本与当前时刻的页面UI实现了紧耦合。而现代Web应用的特点是动态、迭代快。因此，编写定位策略的核心思想，必须从“找到这个元素”转变为 “找到这个业务逻辑所对应的元素，并允许它以某种方式变化”。

---

二、 五大稳定定位策略，从“青铜”到“王者”

策略一：相对定位与轴（Axis）的魔法——XPath的进阶用法

XPath功能强大，但很多人只用了其冰山一角。摒弃绝对路径，利用相对关系和轴，可以写出极具弹性的定位器。

场景1：基于文本内容定位
当元素缺乏稳定属性，但其文本内容是固定时。

# 定位“登录”按钮//button[text()='登录']# 定位包含“提交”文字的按钮（模糊匹配）//button[contains(text(), '提交')]

场景2：利用元素间的层级关系

# 在某个form内，定位其下属的某个input//form[@id='login-form']//input[@name='username']# 注意：这里用了`//`，表示在form内部任何层级查找，比绝对路径更稳定。

场景3：使用轴（Axes）进行上下文定位——这是真正的“杀手锏”
轴可以让你基于一个已知元素，找到与其有特定关系的其他元素。following-sibling:: 定位后续的同级元素

<ul>  <li>苹果</li>  <li class="target">香蕉</li>  <li>橙子</li> <!-- 我们要定位这个 -->  <li>葡萄</li></ul>

已知“香蕉”有class='target'，如何定位后面的“橙子”？

//li[@class='target']/following-sibling::li[1]# 解释：找到class为‘target’的li，然后选择它后面的第一个同级li元素。

• preceding-sibling:: 定位前面的同级元素

• parent:: 定位父元素

//input[@name='username']/parent::div# 找到用户名输入框的父div，常用于包裹表单的容器。

ancestor:: 定位祖先元素

//span[text()='错误信息']/ancestor::div[position()=1]# 找到错误信息文本最近的祖先div，常用于定位整个错误提示区域。

优势： 极大地降低了与整体页面结构的耦合度，即使外层容器div的嵌套关系变了，只要两个元素间的相对关系不变，定位器就依然有效。

---

策略二：多重属性组合与CSS选择器的艺术

当单个属性不够稳定时，将它们组合起来，可以形成一个强大的“复合主键”，显著提高唯一性和稳定性。

CSS选择器在组合方面语法极其简洁高效。

场景1：多属性联合定位

<input type="text" class="form-control" name="email" placeholder="请输入邮箱">

# 用CSS选择器driver.find_element(By.CSS_SELECTOR, "input.form-control[name='email']")# 或者更精确的driver.find_element(By.CSS_SELECTOR, "input[name='email'][type='text']")# 用XPathdriver.find_element(By.XPATH, "//input[@class='form-control' and @name='email']")

场景2：利用属性部分匹配（对付动态ID/Class的神器）
前端框架（如React, Vue）常生成动态变化的ID，如 id="input-1234-abc"。

# CSS 选择器：属性包含某字符串driver.find_element(By.CSS_SELECTOR, "input[id*='input-']")# CSS 选择器：属性以某字符串开头driver.find_element(By.CSS_SELECTOR, "input[id^='input-']")# CSS 选择器：属性以某字符串结尾driver.find_element(By.CSS_SELECTOR, "input[id$='-abc']")# 对应的XPath写法driver.find_element(By.XPATH, "//input[contains(@id, 'input-')]")

场景3：结构化伪类

# 定位表格第三行第二列的单元格driver.find_element(By.CSS_SELECTOR, "table tr:nth-child(3) td:nth-child(2)")# 定位表单中最后一个inputdriver.find_element(By.CSS_SELECTOR, "form input:last-child")

优势： CSS选择器通常比XPath执行速度更快，语法更简洁。通过组合和部分匹配，可以有效应对前端属性的微小变动。

策略三：面向业务的定位器——将UI映射为逻辑对象

这是思想上的一个飞跃。不要直接在测试脚本里写原始的XPath或CSS，而应该创建一个定位器仓库（Page Object模式），并为每个定位器起一个业务相关的名字。

1. 原始、分散的脚本（反面教材）：

# test_login.pydef test_login():    driver.find_element(By.ID, "username").send_keys("user")    driver.find_element(By.ID, "password").send_keys("pass")    driver.find_element(By.XPATH, "//button[text()='登录']").click()    # ... 其他操作也散落各处 ...

2. 使用Page Object Model (POM) 改造后：

# pages/login_page.pyclass LoginPage:    # 定位器仓库    USERNAME_INPUT = (By.ID, "username")    PASSWORD_INPUT = (By.ID, "password")    LOGIN_BUTTON = (By.XPATH, "//button[text()='登录']")
    def __init__(self, driver):        self.driver = driver
    def enter_username(self, username):        self.driver.find_element(*self.USERNAME_INPUT).send_keys(username)
    def enter_password(self, password):        self.driver.find_element(*self.PASSWORD_INPUT).send_keys(password)
    def click_login(self):        self.driver.find_element(*self.LOGIN_BUTTON).click()
    def login(self, username, password):        """一个完整的业务流方法"""        self.enter_username(username)        self.enter_password(password)        self.click_login()# test_login.pyfrom pages.login_page import LoginPagedef test_login():    login_page = LoginPage(driver)    login_page.login("user", "pass") # 测试脚本变得极其清晰

当UI变化时，你只需要在一个地方（LoginPage类）修改定位器，所有用到这个定位器的测试脚本都将自动修复。

优势：

• 极大提升可维护性： 修改UI只需修改一处。

• 提升代码可读性： 测试脚本读起来就像业务文档。

• 促进团队协作： 测试人员关注业务流，框架开发人员关注定位策略。

---

策略四：动态等待与条件触发——让脚本“聪明”地等待

即使你有世界上最完美的定位器，如果元素还没加载出来，一切都是徒劳。稳定性不仅在于“找什么”，还在于“何时找”。

核心：使用Selenium的显式等待（Explicit Wait）替代硬编码的time.sleep和不可靠的隐式等待。

from selenium.webdriver.support.ui import WebDriverWaitfrom selenium.webdriver.support import expected_conditions as ECfrom selenium.webdriver.common.by import Bydef test_dynamic_content():    # 硬编码等待，笨拙且低效    # time.sleep(10)    # element = driver.find_element(By.ID, "dynamic-element")
    # 显式等待，灵活且可靠    wait = WebDriverWait(driver, 10) # 最多等10秒    # 等待元素出现在DOM中    element = wait.until(EC.presence_of_element_located((By.ID, "dynamic-element")))    # 等待元素可见并可点击    element = wait.until(EC.element_to_be_clickable((By.ID, "dynamic-element")))    # 等待元素包含特定文本    element = wait.until(EC.text_to_be_present_in_element((By.ID, "status"), "完成"))

你可以将显式等待与Page Object模式完美结合：

class DynamicPage:    def __init__(self, driver):        self.driver = driver        self.wait = WebDriverWait(driver, 10)
    def get_status(self):        status_element = self.wait.until(            EC.visibility_of_element_located((By.ID, "status"))        )        return status_element.text

优势： 脚本的执行速度达到最优，既不会盲目等待，也不会因为网络或JS延迟而失败。这是让脚本稳定的最关键技术之一。

---

策略五：自定义方法与降级方案——为脚本装上“安全气囊”

即使我们竭尽所能，也无法100%保证某个定位器永远有效。因此，我们需要一个Plan B，甚至Plan C。

场景：实现一个“智能”点击函数，当首选定位器失败时，尝试备用方案。

class RobustLoginPage:    # 主定位器    LOGIN_BUTTON_PRIMARY = (By.ID, "primary-login-btn")    # 备用定位器1：也许有个不同的按钮    LOGIN_BUTTON_FALLBACK1 = (By.CSS_SELECTOR, "button.login-confirm")    # 备用定位器2：最后的手段，通过文本定位    LOGIN_BUTTON_FALLBACK2 = (By.XPATH, "//button[contains(text(), '登')]")
    def smart_click_login(self):        """尝试多种方式点击登录按钮"""        attempts = [self.LOGIN_BUTTON_PRIMARY,                    self.LOGIN_BUTTON_FALLBACK1,                    self.LOGIN_BUTTON_FALLBACK2]
        for attempt, locator in enumerate(attempts, 1):            try:                element = WebDriverWait(self.driver, 5).until(                    EC.element_to_be_clickable(locator)                )                element.click()                print(f"使用定位器方案 {attempt} 点击成功")                return True # 点击成功，退出函数            except TimeoutException:                print(f"定位器方案 {attempt} 失败，尝试下一个...")                continue # 这个方案失败了，尝试下一个
        # 如果所有方案都失败了        print("所有备用定位方案均失败！")        raise NoSuchElementException("无法找到可点击的登录按钮")

另一个高级技巧：利用JavaScript直接操作
当Selenium的常规点击不奏效时（例如被其他元素遮挡，或浏览器兼容性问题），可以降级为执行JS。

def robust_click(self, locator):    try:        element = self.wait.until(EC.element_to_be_clickable(locator))        element.click()    except Exception as e:        print(f"常规点击失败，尝试JS点击: {e}")        # 降级方案：使用JavaScript点击        self.driver.execute_script("arguments[0].click();", element)

优势： 极大提升了脚本的容错能力和自我修复能力，从“一碰就碎”变成“坚韧不拔”。

三、 构建你的稳定定位思维模型

掌握了五种策略，你还需要一个系统化的思维流程来指导实践：

1. 审查元素，优先选择：

• 第一优先级： 唯一且静态的 id、name。

• 第二优先级： 稳定的 data-* 属性（如data-testid，前端测试专用）。

• 第三优先级： 组合属性（CSS选择器）和基于关系的定位（XPath轴）。

2. 模拟破坏性测试： 在开发者工具中，手动修改你打算使用的属性，看你的定位器是否失效。这能帮你提前发现潜在风险。

3. 实施POM： 无论如何，都要使用Page Object模式将定位器与测试逻辑分离。这是长期可维护性的基石。

4. 无等待，不稳定： 为每一个与元素交互的操作（点击、输入等）配上合适的显式等待。

5. 设计降级路径： 对于核心业务流程的关键元素，思考如果首选定位器失效，是否有备选方案。

结语

告别硬编码的定位策略，不仅仅是一次技术升级，更是一次测试工程思想的转变。从依赖单一的、静态的路径，转变为采用相对的、组合的、面向业务的、动态等待的、并有降级方案的综合策略。这五大策略如同为你的自动化脚本穿上了一件坚固的铠甲，让它能够在UI的频繁变化中屹立不倒。

记住，一个优秀的自动化测试项目，其价值不仅在于它能发现多少Bug，更在于它长期稳定运行的可维护性和 ROI（投资回报率）。现在，就拿起这些武器，去重构你的脚本，享受那种“任凭UI风吹浪打，我的脚本岿然不动”的从容与自信吧！

本文原创于【程序员二黑】公众号，转载请注明出处！

欢迎大家关注笔者的公众号：程序员二黑，专注于软件测试干活分享，全套测试资源可免费分享！

最后如果你想学习软件测试，欢迎加入笔者的交流群：785128166，里面会有很多资源和大佬答疑解惑，我们一起交流一起学习！