禅道登录接口自动化测试实践与优化-嵌云网-嵌入式AI开发资源站

禅道登录接口自动化测试实践与优化

甘剑平·2026-10-28·阅读 22 GEO检测（免费）

自动化测试SeleniumRequests

|难度：普通|阅读约 18 分钟

1. 项目概述：禅道登录接口自动化测试的价值与挑战

在软件研发团队中，禅道作为国内使用率最高的项目管理工具之一，其稳定性直接影响团队协作效率。登录模块作为系统的第一道门户，每天承载着高频的认证请求。去年某上市公司就曾因登录接口故障导致全员无法访问任务看板，造成当天迭代进度延误。这让我意识到，对关键业务接口实施自动化测试不是可选项，而是必选项。

Web自动化测试通过模拟用户操作验证系统行为，相比手工测试具有三大不可替代优势：一是可重复执行回归测试（每次发版前自动运行）；二是能捕捉肉眼难发现的响应数据异常（如毫秒级延迟或状态码变化）；三是适合压力场景验证（模拟多用户并发登录）。以禅道登录为例，我们需要覆盖以下核心验证点：

用户名密码正确时的200响应及Session生成
错误凭证时的403状态码返回
验证码功能启用时的交互逻辑
连续失败后的账户锁定机制

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 技术选型：Selenium与Requests的对比实践

2.1 基于UI层的Selenium方案

当测试需要模拟真实用户操作时，Selenium仍是首选工具。最新版Selenium 4.8支持更智能的元素定位策略，以下是使用Python实现的典型代码结构：

python复制from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.common.exceptions import NoSuchElementException

driver = webdriver.Chrome()
driver.get("http://zentao.example.com/login")

try:
    driver.find_element(By.ID, "account").send_keys("admin")
    driver.find_element(By.NAME, "password").send_keys("123456")
    driver.find_element(By.ID, "submit").click()
    
    # 验证登录后元素
    assert driver.find_element(By.CLASS_NAME, "user-name").text == "管理员"
except NoSuchElementException as e:
    print(f"元素定位失败: {str(e)}")
finally:
    driver.quit()

关键改进点：

使用显式等待替代固定sleep：

python复制from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

WebDriverWait(driver, 10).until(
    EC.presence_of_element_located((By.ID, "mainMenu"))
)

通过Page Object模式封装元素定位：

python复制class LoginPage:
    def __init__(self, driver):
        self.driver = driver
        self.url = "http://zentao.example.com/login"
    
    def load(self):
        self.driver.get(self.url)
    
    def login(self, username, password):
        self.driver.find_element(By.ID, "account").send_keys(username)
        self.driver.find_element(By.NAME, "password").send_keys(password)
        self.driver.find_element(By.ID, "submit").click()

2.2 基于API层的Requests方案

对于纯接口验证，Requests库效率更高。禅道登录接口通常采用表单提交方式：

python复制import requests

session = requests.Session()
login_url = "http://zentao.example.com/user-login.json"

payload = {
    "account": "admin",
    "password": "123456",
    "keepLogin": "on"
}

response = session.post(login_url, data=payload)
print(response.status_code)  # 预期输出200
print(response.json().get("status"))  # 检查返回状态

安全增强技巧：

密码加密处理（即使测试环境也应养成习惯）：

python复制from hashlib import md5

def encrypt_pwd(pwd):
    return md5(pwd.encode()).hexdigest().upper()

payload["password"] = encrypt_pwd("123456")

添加请求超时与重试机制：

python复制from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry

retry_strategy = Retry(
    total=3,
    backoff_factor=1,
    status_forcelist=[500, 502, 503]
)
adapter = HTTPAdapter(max_retries=retry_strategy)
session.mount("http://", adapter)
session.mount("https://", adapter)

3. 测试框架深度集成方案

3.1 Pytest测试骨架搭建

创建符合企业级标准的测试目录结构：

code复制tests/
├── conftest.py
├── fixtures/
│   └── zentao.py
├── test_login/
│   ├── test_ui_login.py
│   └── test_api_login.py
└── utils/
    ├── logger.py
    └── assert_tools.py

典型测试用例示例：

python复制import pytest
from fixtures.zentao import zentao_api

@pytest.mark.parametrize("user,pwd,expected", [
    ("admin", "correct_pwd", 200),
    ("test", "wrong_pwd", 403),
    ("", "", 400)
])
def test_api_login(zentao_api, user, pwd, expected):
    response = zentao_api.login(user, pwd)
    assert response.status_code == expected

3.2 持续集成流水线配置

GitLab CI示例配置：

yaml复制stages:
  - test

ui_tests:
  stage: test
  image: selenium/standalone-chrome
  script:
    - pip install -r requirements.txt
    - pytest tests/test_login/test_ui_login.py --html=report.html
  artifacts:
    paths:
      - report.html

api_tests:
  stage: test
  image: python:3.9
  script:
    - pip install -r requirements.txt
    - pytest tests/test_login/test_api_login.py --junitxml=api-report.xml
  artifacts:
    paths:
      - api-report.xml

4. 企业级增强实践

4.1 安全测试扩展

在基础功能测试外，应增加安全扫描：

python复制import owasp_zap_v2_4 as zap

def test_login_security():
    zap = ZAPv2(apikey="your_key", proxies={'http': 'http://localhost:8080'})
    scan_id = zap.ascan.scan(target)
    while int(zap.ascan.status(scan_id)) < 100:
        time.sleep(5)
    
    alerts = zap.core.alerts()
    assert not any(alert['risk'] == 'High' for alert in alerts)

4.2 性能测试集成

使用Locust模拟并发登录：

python复制from locust import HttpUser, task

class ZentaoUser(HttpUser):
    @task
    def login(self):
        self.client.post("/user-login.json", {
            "account": "test_user",
            "password": "test123"
        })

执行命令：

bash复制locust -f locustfile.py --headless -u 100 -r 10 --run-time 1h

5. 常见问题排坑指南

元素定位失效问题

现象：脚本运行时提示NoSuchElementException

解决方案：

使用相对定位替代绝对XPath：

python复制# 不推荐
driver.find_element(By.XPATH, "/html/body/div[3]/div/div[2]/form/div[1]/input")

# 推荐
driver.find_element(By.CSS_SELECTOR, "form.form-vertical input[name='account']")

添加动态等待策略

验证码处理方案

测试环境关闭验证码（修改禅道配置）
使用OCR识别（Tesseract方案）：

python复制import pytesseract
from PIL import Image

captcha = driver.find_element(By.ID, "captcha")
captcha.screenshot("captcha.png")
text = pytesseract.image_to_string(Image.open("captcha.png"))
driver.find_element(By.NAME, "captcha").send_keys(text)

Session保持技巧

python复制# 在conftest.py中实现会话复用
@pytest.fixture(scope="module")
def auth_session():
    s = requests.Session()
    s.post(login_url, data=valid_cred)
    yield s
    s.get(logout_url)

6. 测试数据管理策略

6.1 参数化数据驱动

使用外部JSON文件管理测试账户：

json复制// accounts.json
{
  "valid": [
    {"role": "admin", "user": "admin1", "pwd": "P@ssw0rd"},
    {"role": "dev", "user": "dev_01", "pwd": "Dev123!"}
  ],
  "invalid": [
    {"case": "wrong_pwd", "user": "admin1", "pwd": "wrong"},
    {"case": "empty_user", "user": "", "pwd": "test123"}
  ]
}

测试用例引用：

python复制with open("accounts.json") as f:
    test_data = json.load(f)

@pytest.mark.parametrize("account", test_data["valid"])
def test_valid_login(account):
    # 测试逻辑...

6.2 数据库验证扩展

直接验证数据库写入：

python复制import pymysql

def test_login_log():
    conn = pymysql.connect(host="db.example.com", user="tester", password="test123", database="zentao")
    try:
        with conn.cursor() as cursor:
            cursor.execute("SELECT COUNT(*) FROM zt_userLog WHERE account='admin' AND action='login'")
            assert cursor.fetchone()[0] > 0
    finally:
        conn.close()

7. 测试报告优化方案

7.1 Allure集成

生成美观的交互式报告：

python复制import allure

@allure.title("验证管理员登录功能")
@allure.feature("登录模块")
def test_admin_login():
    with allure.step("输入管理员凭证"):
        # 操作步骤...
    with allure.step("验证登录状态"):
        # 断言...

7.2 自定义HTML报告

使用pytest-html扩展并添加截图：

python复制from base64 import b64encode

def pytest_runtest_makereport(item, call):
    if call.when == "call" and call.excinfo:
        driver = item.funcargs["driver"]
        screenshot = driver.get_screenshot_as_base64()
        html = f'<div><img src="data:image/png;base64,{screenshot}"></div>'
        extra = getattr(report, "extra", [])
        extra.append(pytest_html.extras.html(html))
        report.extra = extra

8. 移动端兼容性测试

虽然主要测试Web端，但需要考虑移动浏览器访问：

python复制from selenium.webdriver.chrome.options import Options

mobile_emulation = {
    "deviceMetrics": {"width": 375, "height": 812, "pixelRatio": 3.0},
    "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 13_2_3 like Mac OS X)..."
}

chrome_options = Options()
chrome_options.add_experimental_option("mobileEmulation", mobile_emulation)
driver = webdriver.Chrome(options=chrome_options)

9. 可视化监控看板

将测试结果接入Grafana：

python复制import influxdb

client = influxdb.InfluxDBClient(host='localhost', port=8086)
json_body = [{
    "measurement": "api_response",
    "tags": {"api": "login"},
    "fields": {"duration": response.elapsed.microseconds}
}]
client.write_points(json_body)

10. 测试环境治理

10.1 容器化测试环境

使用Docker Compose快速搭建：

yaml复制version: '3'
services:
  zentao:
    image: easysoft/zentao:latest
    ports:
      - "8080:80"
  selenium-hub:
    image: selenium/hub
    ports:
      - "4444:4444"
  chrome:
    image: selenium/node-chrome
    depends_on:
      - selenium-hub
    environment:
      - SE_EVENT_BUS_HOST=selenium-hub

10.2 测试数据自动清理

通过API实现数据重置：

python复制@pytest.fixture(autouse=True)
def clean_test_data():
    yield
    requests.post("http://zentao.example.com/reset-test-data", 
                 headers={"X-Auth-Token": "secret"})

在实际项目中，我们通过这套自动化测试体系将禅道登录模块的缺陷发现率提升了60%，回归测试时间从原来的2小时缩短到8分钟。特别是在处理SSO集成和LDAP认证扩展时，自动化测试快速验证了各种边界场景，避免了至少3次重大线上事故。