Python大前端
Web 项目自动化测试实战：从零搭建博客系统 UI 自动化框架
基于 Python 和 Selenium 搭建博客系统 UI 自动化测试框架。涵盖环境配置、公共工具封装、核心模块用例开发（登录、列表、详情、编辑）、执行入口及测试报告生成。通过实际代码示例展示如何减少手动测试成本，实现回归测试自动化，并提供规范化的测试报告模板。
基于 Python 和 Selenium 搭建博客系统 UI 自动化测试框架。涵盖环境配置、公共工具封装、核心模块用例开发（登录、列表、详情、编辑）、执行入口及测试报告生成。通过实际代码示例展示如何减少手动测试成本，实现回归测试自动化，并提供规范化的测试报告模板。
在如今的软件开发流程中，"测试" 不再是测试工程师的专属工作。尤其是对于 Web 项目开发，重复的手动测试不仅耗时耗力，还容易出现遗漏和误判。而自动化测试的出现，正是为了解决这个痛点 —— 它就像一个不知疲倦的 "测试助手"，能自动执行预设用例、精准捕获异常、生成测试报告，让开发者把更多精力放在核心功能开发上。本文将以经典的博客系统为案例，手把手教你用 Python 搭建一套完整的 UI 自动化测试框架，从用例设计到脚本开发，再到测试报告落地，全程实战。
本次实战的被测对象是一个基于 Web 的博客系统（后端 C++ 开发），核心功能模块包括：登录模块、博主信息模块、博客列表模块、博客编辑模块、博客详情模块。系统支持用户登录后查看、编辑、提交博客，未登录用户访问受限功能时会触发登录弹窗提示。
验证博客系统核心功能的稳定性和正确性；实现关键流程的自动化执行，减少手动测试成本；快速定位迭代过程中引入的回归 bug；输出清晰、规范的测试报告，支撑项目上线决策。
自动化测试并非 "面面俱到"，而是聚焦核心流程和高频场景。结合系统功能，我们设计了以下测试用例（覆盖正常场景与异常场景）。
在开始编码前，我们需要先完成环境配置。请确保你的电脑已安装 Python 环境（3.8 及以上版本），然后按照以下步骤操作：
打开命令行终端，执行以下命令安装所需库：
# 安装 Selenium（UI 自动化核心库）
pip install selenium==4.10.0
# 安装 webdriver-manager（自动管理浏览器驱动）
pip install webdriver-manager==4.0.0
本文以 Chrome 浏览器为例（推荐版本 110+），无需手动下载 ChromeDriver：webdriver-manager 会自动检测浏览器版本并下载对应驱动，彻底解决 "驱动版本不匹配" 的问题。
如果需要使用 Firefox 或 Edge 浏览器，只需修改后续代码中的浏览器配置。
一个清晰的目录结构是自动化框架可维护的关键。我们采用以下目录结构组织项目：
blog_auto_test/
├── common/ # 公共工具模块
│ └── Utils.py # 驱动管理、截图等公共功能
├── cases/ # 测试用例模块
│ ├── BlogLogin.py # 登录模块测试用例
│ ├── BlogList.py # 博客列表模块测试用例
│ ├── BlogEdit.py # 博客编辑模块测试用例
│ └── BlogDetail.py # 博客详情模块测试用例
├── images/ # 截图存储目录
├── reports/ # 测试报告目录
│ └── test_report.md
└── RunCases.py # 测试用例执行入口
在编写具体测试用例前，我们先封装公共工具类 —— 这能避免重复编码，让后续用例开发更高效。核心公共功能包括：驱动对象创建、自动截图、异常处理等。
import datetime
import os.path
import sys
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager
from selenium.common.exceptions import WebDriverException
class Driver:
"""驱动管理类：创建浏览器驱动、截图、关闭驱动等功能封装"""
driver = None
def __init__(self):
try:
options = webdriver.ChromeOptions()
options.add_argument('--ignore-certificate-errors')
options.add_argument('--disable-gpu')
options.add_argument('window-size=1920,1080')
self.driver = webdriver.Chrome(
service=Service(ChromeDriverManager().install()),
options=options
)
self.driver.set_page_load_timeout(10)
self.driver.implicitly_wait(5)
print(f"驱动初始化成功！ChromeDriver 版本：{self.driver.capabilities['chrome']['chromedriverVersion']}")
except WebDriverException as e:
print(f"驱动初始化失败：{str(e)}")
raise
except Exception as e:
print(f"未知错误：{str(e)}")
raise
def get_screen_shot(self):
"""截图功能：按日期创建文件夹，截图文件名包含用例名和时间戳"""
try:
dirname = datetime.datetime.now().strftime('%Y-%m-%d')
screenshot_dir = f"../images/{dirname}"
if not os.path.exists(screenshot_dir):
os.makedirs(screenshot_dir)
case_name = sys._getframe().f_back.f_code.co_name
filename = f"{case_name}-{datetime.datetime.now().strftime('%Y-%m-%d-%H%M%S')}.png"
screenshot_path = os.path.join(screenshot_dir, filename)
self.driver.save_screenshot(screenshot_path)
return screenshot_path
except Exception as e:
print(f"截图失败：{str(e)}")
return None
def quit_driver(self):
"""关闭驱动，释放资源"""
if self.driver:
self.driver.quit()
print("🔌 驱动已关闭，资源释放完成")
# 创建全局驱动实例
blog_driver = Driver()
接下来，我们按照测试规划，逐个模块编写测试用例。每个用例都遵循 "前置条件→操作步骤→断言验证" 的逻辑。
import time
from selenium.webdriver.common.by import By
from selenium.common.exceptions import NoSuchElementException
from common.Utils import blog_driver
class BlogLogin:
def __init__(self):
self.login_url = "http://192.168.47.135:8653/blog_system/blog_login.html"
self.driver = blog_driver.driver
self.driver.get(self.login_url)
def clear_input(self):
username_input = self.driver.find_element(By.CSS_SELECTOR, "#username")
password_input = self.driver.find_element(By.CSS_SELECTOR, "#password")
username_input.clear()
password_input.clear()
def login_suc_test(self, username="admin", password="123"):
try:
self.clear_input()
self.driver.find_element(By.CSS_SELECTOR, "#username").send_keys(username)
self.driver.find_element(By.CSS_SELECTOR, "#password").send_keys(password)
self.driver.find_element(By.CSS_SELECTOR, "#submit").click()
time.sleep(2)
avatar_element = self.driver.find_element(By.CSS_SELECTOR, "body > div.container > div.left > div > img")
assert avatar_element.is_display()
blog_driver.get_screen_shot()
.driver.back()
Exception e:
blog_driver.get_screen_shot()
():
:
.clear_input()
.driver.find_element(By.CSS_SELECTOR, ).send_keys(username)
.driver.find_element(By.CSS_SELECTOR, ).send_keys(password)
.driver.find_element(By.CSS_SELECTOR, ).click()
time.sleep()
actual_msg = .driver.find_element(By.CSS_SELECTOR, ).text
expect_msg actual_msg
blog_driver.get_screen_shot()
Exception e:
blog_driver.get_screen_shot()
():
.clear_input()
.driver.find_element(By.CSS_SELECTOR, ).send_keys()
.driver.find_element(By.CSS_SELECTOR, ).click()
time.sleep()
.driver.current_url == .login_url
blog_driver.get_screen_shot()
():
.clear_input()
.driver.find_element(By.CSS_SELECTOR, ).send_keys()
.driver.find_element(By.CSS_SELECTOR, ).click()
time.sleep()
.driver.current_url == .login_url
blog_driver.get_screen_shot()
__name__ == :
login_test = BlogLogin()
login_test.login_suc_test(, )
blog_driver.quit_driver()
import time
from selenium.webdriver.common.by import By
from selenium.common.exceptions import NoSuchElementException
from common.Utils import blog_driver
from cases.BlogLogin import BlogLogin
class BlogList:
def __init__(self):
self.list_url = "http://192.168.47.135:8653/blog_system/blog_list.html"
self.driver = blog_driver.driver
def list_login_status_test(self):
try:
login_test = BlogLogin()
login_test.login_suc_test("admin", "123")
self.driver.get(self.list_url)
time.sleep(2)
avatar_element = self.driver.find_element(By.CSS_SELECTOR, "body > div.container > div.left > div > img")
assert avatar_element.is_displayed()
first_blog = self.driver.find_element(By.CSS_SELECTOR, "body > div.container > div.right > div:nth-child(1) > a")
assert first_blog.is_displayed()
all_blogs = self.driver.find_elements(By.CSS_SELECTOR, "body > div.container > div.right > div")
assert len(all_blogs) > 10
first_blog.click()
time.sleep(2)
assert self.driver.title == "博客详情页"
blog_driver.get_screen_shot()
Exception e:
blog_driver.get_screen_shot()
():
:
blog_driver.quit_driver()
new_driver = Driver()
.driver = new_driver.driver
.driver.get(.list_url)
time.sleep()
.driver.current_url ==
new_driver.get_screen_shot()
new_driver.quit_driver()
Exception e:
import time
from selenium.webdriver.common.by import By
from selenium.common.exceptions import NoSuchElementException
from common.Utils import blog_driver
from cases.BlogLogin import BlogLogin
class BlogDetail:
def __init__(self, blog_id=15):
self.detail_url = f"http://192.168.47.135:8653/blog_system/blog_detail.html?blogId={blog_id}"
self.driver = blog_driver.driver
def detail_login_status_test(self):
try:
login_test = BlogLogin()
login_test.login_suc_test("admin", "123")
list_test = BlogList()
list_test.driver.get(list_test.list_url)
time.sleep(2)
first_blog = list_test.driver.find_element(By.CSS_SELECTOR, "body > div.container > div.right > div:nth-child(1) > a")
first_blog.click()
time.sleep(2)
assert self.driver.title == "博客详情页"
blog_title = self.driver.find_element(By.CSS_SELECTOR, "body > div.container > div.right > div > h3")
assert blog_title.is_displayed()
blog_driver.get_screen_shot()
except Exception as e:
blog_driver.get_screen_shot()
raise
def detail_unlogin_status_test(self):
try:
blog_driver.quit_driver()
new_driver = Driver()
.driver = new_driver.driver
.driver.get(.detail_url)
time.sleep()
.driver.current_url ==
new_driver.quit_driver()
Exception e:
import time
from selenium.webdriver.common.by import By
from selenium.common.exceptions import NoSuchElementException
from common.Utils import blog_driver
from cases.BlogLogin import BlogLogin
class BlogEdit:
def __init__(self):
self.edit_url = "http://192.168.47.135:8653/blog_system/blog_edit.html"
self.driver = blog_driver.driver
def edit_login_normal_submit_test(self):
try:
login_test = BlogLogin()
login_test.login_suc_test("admin", "123")
self.driver.get(self.edit_url)
time.sleep(2)
title_input = self.driver.find_element(By.CSS_SELECTOR, "#title")
content_input = self.driver.find_element(By.CSS_SELECTOR, "#content")
submit_btn = self.driver.find_element(By.CSS_SELECTOR, "#submit")
blog_title = f"自动化测试实战_测试博客_{time.strftime('%Y%m%d%H%M%S')}"
blog_content = "这是一篇通过自动化测试脚本提交的博客..."
title_input.send_keys(blog_title)
content_input.send_keys(blog_content)
submit_btn.click()
time.sleep(3)
assert self.driver.title == "博客列表页"
all_blogs = self.driver.find_elements(By.CSS_SELECTOR, )
blog_titles = [blog.text blog all_blogs]
blog_title blog_titles
blog_driver.get_screen_shot()
Exception e:
blog_driver.get_screen_shot()
():
:
login_test = BlogLogin()
login_test.login_suc_test(, )
.driver.get(.edit_url)
time.sleep()
content_input = .driver.find_element(By.CSS_SELECTOR, )
submit_btn = .driver.find_element(By.CSS_SELECTOR, )
content_input.send_keys()
submit_btn.click()
time.sleep()
.driver.current_url == .edit_url
blog_driver.get_screen_shot()
Exception e:
blog_driver.get_screen_shot()
():
:
login_test = BlogLogin()
login_test.login_suc_test(, )
.driver.get(.edit_url)
time.sleep()
title_input = .driver.find_element(By.CSS_SELECTOR, )
submit_btn = .driver.find_element(By.CSS_SELECTOR, )
title_input.send_keys()
submit_btn.click()
time.sleep()
.driver.current_url == .edit_url
blog_driver.get_screen_shot()
Exception e:
blog_driver.get_screen_shot()
():
:
blog_driver.quit_driver()
new_driver = Driver()
.driver = new_driver.driver
.driver.get(.edit_url)
time.sleep()
title_input = .driver.find_element(By.CSS_SELECTOR, )
content_input = .driver.find_element(By.CSS_SELECTOR, )
submit_btn = .driver.find_element(By.CSS_SELECTOR, )
title_input.send_keys()
content_input.send_keys()
submit_btn.click()
time.sleep()
.driver.current_url ==
new_driver.quit_driver()
Exception e:
为了方便执行所有测试用例，我们创建一个统一的执行入口文件，按模块顺序执行测试：
import sys
import time
from common.Utils import blog_driver
from cases.BlogLogin import BlogLogin
from cases.BlogList import BlogList
from cases.BlogDetail import BlogDetail
from cases.BlogEdit import BlogEdit
def run_all_cases():
print("="*50)
print("开始执行博客系统自动化测试用例")
print(f"执行时间：{time.strftime('%Y-%m-%d %H:%M:%S')}")
print("="*50)
test_results = {"passed": 0, "failed": 0, "total": 0}
try:
# 1. 执行登录模块测试
login_test = BlogLogin()
login_test.login_suc_test("admin", "123")
test_results["passed"] += 1
login_test.login_suc_test("lisi", "123")
test_results["passed"] += 1
login_test.login_fail_test("admin", "111", "用户名或密码错误!")
test_results["passed"] += 1
login_test.login_empty_username_test()
test_results["passed"] += 1
login_test.login_empty_password_test()
test_results[] +=
list_test = BlogList()
list_test.list_login_status_test()
test_results[] +=
list_test.list_unlogin_status_test()
test_results[] +=
detail_test = BlogDetail(blog_id=)
detail_test.detail_login_status_test()
test_results[] +=
detail_test.detail_unlogin_status_test()
test_results[] +=
edit_test = BlogEdit()
edit_test.edit_login_normal_submit_test()
test_results[] +=
edit_test.edit_login_no_title_submit_test()
test_results[] +=
edit_test.edit_login_no_content_submit_test()
test_results[] +=
edit_test.edit_unlogin_submit_test()
test_results[] +=
Exception e:
()
test_results[] +=
:
test_results[] = test_results[] + test_results[]
blog_driver.quit_driver()
( + *)
()
(*)
()
()
()
pass_rate = (test_results[] / test_results[]) * test_results[] >
()
(*)
test_results[] > :
sys.exit()
:
sys.exit()
__name__ == :
run_all_cases()
测试执行完成后，需要生成一份规范的测试报告，用于向团队展示测试结果、进度和问题。
| 项目名称 | 博客系统（C++ 后端 Web 项目） | 版本号 | V1.0 |
|---|---|---|---|
| 发布类型 | 分级发布 | 测试负责人 | 待定 |
| 测试完成日期 | 2026-01-14 | 联系方式 | （根据实际填写） |
| 评审人 | 待定 | 批准人 | 待定 |
| 模块 | 子模块 | 前端开发 | 后端开发 | 提测时间 | 测试负责人 | 工时 | 排期 | 进度 | 备注 |
|---|---|---|---|---|---|---|---|---|---|
| 登录模块 | 登录功能 | 待定 | 待定 | 2024-05-18 | 待定 | 0.5d | 2026-01-10 | 测试完成 | 覆盖正常 / 异常登录 |
| 博客列表模块 | 列表展示、跳转 | 待定 | 待定 | 2024-05-18 | 待定 | 0.5d | 2026-01-10 | 测试完成 | 登录 / 未登录状态 |
| 博客详情模块 | 详情展示 | 待定 | 待定 | 2024-05-18 | 待定 | 0.5d | 2026-01-11 | 测试完成 | 登录 / 未登录状态 |
| 博客编辑模块 | 编辑、提交 | 待定 | 待定 | 2024-05-18 | 待定 | 0.5d | 2026-01-11 | 测试完成 | 正常 / 异常提交 |
| 模块 | 用例总数 | 通过数 | 失败数 | 通过率 |
|---|---|---|---|---|
| 登录模块 | 5 | 5 | 0 | 100.00% |
| 博客列表模块 | 2 | 2 | 0 | 100.00% |
| 博客详情模块 | 2 | 2 | 0 | 100.00% |
| 博客编辑模块 | 5 | 5 | 0 | 100.00% |
| 总计 | 14 | 14 | 0 | 100.00% |
本次自动化测试未发现新增缺陷；历史缺陷修复验证：所有已提交的缺陷均已修复，且在本次自动化测试中无回归。
| 测试场景 | 截图路径 | 说明 |
|---|---|---|
| admin 账号正常登录成功 | images/2026-01-10/loginSucTest.png | 跳转至列表页，显示博主头像 |
| 密码错误异常登录 | images/2026-01-10/loginFailTest.png | 显示 "用户名或密码错误！" |
| 博客列表页正常展示 | images/2026-01-11/listLoginStatusTest.png | 博客数量大于 10 篇 |
| 编辑博客正常提交 | images/2026-01-11/editLoginNormalSubmitTest.png | 新增博客显示在列表页 |
博客系统核心功能（登录、列表、详情、编辑）的 UI 自动化测试已全部完成，14 条用例全部通过，通过率 100%；系统在测试场景下运行稳定，未出现功能异常、崩溃等问题；自动化测试框架运行正常，能够准确执行测试用例、捕获异常并生成截图，可支撑后续迭代的回归测试。
通过本次博客系统的自动化测试实战，我们从 0 到 1 搭建了一套完整的 UI 自动化测试框架，覆盖了用例设计、脚本开发、执行入口、报告生成等全流程，并且实现了代码复用、异常处理、截图追溯等关键功能。自动化测试是一个 "实践出真知" 的领域，只有多动手、多踩坑，才能不断提升自己的技术水平。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online