1. TPshop项目UI自动化测试环境搭建在开始编写初始化代码之前我们需要先搭建好测试环境。TPshop作为一个开源电商系统其UI自动化测试主要依赖Selenium和pytest框架。我建议使用Python 3.8版本因为这个版本对相关库的支持最稳定。首先安装必要的依赖包pip install selenium pytest pytest-html allure-pytest对于浏览器驱动我强烈推荐使用WebDriver Manager来自动管理这能省去手动下载和配置的麻烦from webdriver_manager.chrome import ChromeDriverManager from selenium.webdriver.chrome.service import Service service Service(ChromeDriverManager().install())注意在实际企业项目中建议将所有的依赖包及其版本号记录在requirements.txt文件中方便团队其他成员快速搭建相同环境。2. 项目目录结构设计一个良好的目录结构是自动化测试项目成功的基础。经过多个项目的实践我总结出以下最适合TPshop项目的结构tpshop_ui_test/ ├── config/ # 配置文件 │ ├── __init__.py │ ├── settings.py # 全局配置 │ └── elements.py # 页面元素定位 ├── pages/ # 页面对象 │ ├── __init__.py │ ├── base_page.py # 基础页面类 │ ├── login_page.py # 登录页面 │ └── ... # 其他页面 ├── testcases/ # 测试用例 │ ├── __init__.py │ ├── test_login.py # 登录测试 │ └── ... # 其他测试 ├── utils/ # 工具类 │ ├── __init__.py │ ├── logger.py # 日志工具 │ └── common.py # 公共方法 ├── reports/ # 测试报告 ├── conftest.py # pytest配置 └── run.py # 执行入口这种结构的好处是实现了业务逻辑与测试代码的分离便于后期维护和扩展符合Page Object设计模式方便团队协作开发3. 核心初始化代码实现3.1 浏览器驱动封装浏览器驱动是UI自动化的核心我们需要对其进行良好的封装from selenium import webdriver from selenium.webdriver.chrome.options import Options def init_driver(headlessFalse): chrome_options Options() if headless: chrome_options.add_argument(--headless) chrome_options.add_argument(--disable-gpu) chrome_options.add_argument(--no-sandbox) chrome_options.add_argument(--disable-dev-shm-usage) chrome_options.add_argument(--window-size1920,1080) driver webdriver.Chrome(serviceservice, optionschrome_options) driver.implicitly_wait(10) # 隐式等待 driver.maximize_window() return driver这个初始化函数提供了以下关键功能支持无头模式运行适合CI/CD环境设置了合理的浏览器参数避免常见的内存问题配置了隐式等待增强脚本稳定性默认最大化窗口确保元素可见3.2 基础页面类设计基础页面类是所有页面对象的父类封装了常用的操作方法from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC class BasePage: def __init__(self, driver): self.driver driver self.wait WebDriverWait(driver, 15) # 显式等待 def find_element(self, locator): return self.wait.until(EC.presence_of_element_located(locator)) def click(self, locator): self.wait.until(EC.element_to_be_clickable(locator)).click() def send_keys(self, locator, text): element self.wait.until(EC.visibility_of_element_located(locator)) element.clear() element.send_keys(text) def get_text(self, locator): return self.wait.until(EC.visibility_of_element_located(locator)).text def is_displayed(self, locator): try: return self.find_element(locator).is_displayed() except: return False这个基础类实现了统一的元素定位方式智能等待机制常用的页面操作方法异常处理4. pytest框架配置与优化4.1 conftest.py配置pytest的强大之处在于它的fixture机制我们可以通过conftest.py文件共享fixtureimport pytest from selenium import webdriver pytest.fixture(scopesession) def driver(): driver init_driver(headlessTrue) yield driver driver.quit() pytest.fixture def login(driver): # 实现登录逻辑 yield # 登出逻辑这样配置后所有测试用例都可以直接使用这些fixture无需重复编写初始化代码。4.2 测试报告生成良好的测试报告对于问题定位至关重要。我们可以同时生成多种格式的报告# 在pytest.ini中配置 [pytest] addopts --htmlreports/report.html --self-contained-html --alluredirreports/allure-results执行测试后可以通过以下命令生成Allure报告allure serve reports/allure-results5. 常见问题与解决方案在实际项目中我遇到过以下几个典型问题及解决方法元素定位不稳定原因页面加载速度不一致解决合理设置等待时间优先使用显式等待测试数据管理混乱原因硬编码在测试用例中解决使用外部数据文件JSON/YAML管理测试数据并行测试冲突原因共享浏览器实例解决使用pytest-xdist插件每个线程独立浏览器实例验证码处理方案1测试环境关闭验证码方案2使用OCR技术识别方案3设置万能验证码测试执行速度慢优化1减少不必要的页面刷新优化2使用无头模式优化3合理组织测试用例顺序6. 持续集成实践将UI自动化测试集成到CI/CD流程中可以极大提高效率。以下是GitLab CI的配置示例stages: - test ui_test: stage: test image: python:3.8 before_script: - pip install -r requirements.txt - apt-get update apt-get install -y chromium script: - pytest --alluredirreports/allure-results artifacts: when: always paths: - reports/这个配置实现了自动安装依赖在容器中运行测试保存测试结果可以与后续部署阶段集成7. 项目实战技巧经过多个TPshop项目的实践我总结了以下宝贵经验元素定位策略优先使用相对稳定的定位方式如CSS选择器避免使用绝对XPath为关键元素添加有意义的ID或class测试用例设计遵循准备-执行-断言模式每个测试用例保持独立合理使用参数化减少重复代码调试技巧使用pdb设置断点在失败时截图保存记录详细的操作日志性能优化重用浏览器会话批量执行相似操作避免不必要的页面刷新团队协作统一编码规范定期代码审查建立共享元素库这套初始化代码框架已经在多个TPshop项目中得到验证能够显著提高UI自动化测试的稳定性和可维护性。根据项目实际情况你可以在此基础上进一步扩展和优化。
