18.4.3 自动化测试体系与质量门禁

自动化测试体系覆盖单元测试、接口测试、集成测试、端到端测试与安全/性能回归，遵循“测试左移、快速反馈、可重复”。在流水线中按阶段分层执行：提交触发运行单元测试与静态检查；合并或夜间构建运行接口/集成测试；发布前运行端到端与性能回归，并将结果统一汇总到报告平台与制品元数据中。

原理与流程草图（测试分层与质量门禁）：

质量门禁用于在关键节点阻断低质量变更，常见门禁项包括：测试通过率、覆盖率阈值、静态扫描严重缺陷、依赖漏洞风险等级、构建时长/失败率、回归测试通过率。门禁应与分支策略结合：主干合并强制通过全量门禁，开发分支允许部分门禁告警但需记录风险。

测试执行与管理建议（含命令示例）：
- 单元测试：与构建阶段绑定，失败即中止；覆盖率低于阈值直接阻断。
- 接口测试：以契约测试为核心；对外部依赖用Mock或测试环境隔离。
- 集成测试：通过容器化或临时环境进行，保证服务协同能力。
- 端到端测试：覆盖关键业务路径，控制用例规模与运行时间。
- 性能与安全：对基线版本建立指标阈值，回归对比异常则触发告警或阻断。

示例：Jenkins Pipeline 分层测试与质量门禁（含覆盖率与静态扫描）

// Jenkinsfile
pipeline {
  agent any
  tools { jdk 'jdk11' maven 'maven3' }
  environment {
    COVERAGE_MIN = '80'
  }
  stages {
    stage('Checkout') {
      steps { checkout scm }
    }
    stage('Unit Test & Coverage') {
      steps {
        sh 'mvn -B -DskipITs=false test'
        sh 'mvn -B jacoco:report'
      }
      post {
        always {
          junit 'target/surefire-reports/*.xml'
          publishHTML([reportDir: 'target/site/jacoco', reportFiles: 'index.html', reportName: 'JaCoCo'])
        }
      }
    }
    stage('Static Scan') {
      steps {
        sh 'mvn -B spotbugs:spotbugs'
      }
      post {
        always { archiveArtifacts 'target/spotbugsXml.xml' }
      }
    }
    stage('API Test') {
      steps {
        sh 'newman run tests/api.postman_collection.json -r junit --reporter-junit-export target/newman.xml'
      }
      post {
        always { junit 'target/newman.xml' }
      }
    }
    stage('Quality Gate') {
      steps {
        sh '''
          COV=$(grep -o "TOTAL.*" -n target/site/jacoco/index.html | awk -F'%' '{print $1}' | tail -1 | grep -o "[0-9]*$")
          if [ -z "$COV" ]; then echo "Coverage parse failed"; exit 2; fi
          if [ "$COV" -lt "$COVERAGE_MIN" ]; then
            echo "Coverage $COV < $COVERAGE_MIN, fail gate"; exit 1
          fi
        '''
      }
    }
  }
}

示例：契约测试（Pact）与服务隔离（Mock）

# 生成契约（消费者）
mvn -B -Dtest=PactConsumerTest test
# 发布契约到仓库（示例地址）
curl -X POST http://pact-broker:9292/pacts/provider/UserService/consumer/WebApp/version/1.0.0 \
  -H "Content-Type: application/json" \
  -d @target/pacts/webapp-userservice.json

示例：端到端测试（Selenium）与结果归档

# 运行 E2E 测试并输出 JUnit 报告
mvn -B -Dtest=E2ETest test
# 期望输出：target/surefire-reports/TEST-*.xml

结果治理与可视化：
- 统一测试报告格式（JUnit/Allure），归档并关联构建号与制品版本。
- 失败用例自动分派与重试策略，区分环境问题与代码问题。
- 质量趋势仪表盘：通过率、覆盖率、缺陷密度、平均修复时长。

示例：Allure 报告生成与归档

# 安装 Allure CLI（Linux）
wget -qO- https://github.com/allure-framework/allure2/releases/download/2.24.1/allure-2.24.1.tgz \
  | tar -xz -C /opt
ln -s /opt/allure-2.24.1/bin/allure /usr/local/bin/allure

# 生成报告
allure generate ./allure-results -o ./allure-report --clean

门禁策略示例：
- 单元测试通过率=100%，覆盖率≥80%；
- 静态扫描“阻断级”缺陷为0；
- 依赖漏洞High以上为0；
- 关键接口契约测试通过率=100%；
- 性能回归关键指标劣化≤5%。

安装与环境准备（示例）：

# 安装 Java/Maven（以Ubuntu为例）
sudo apt-get update
sudo apt-get install -y openjdk-11-jdk maven

# 安装 Node.js 与 Newman（接口测试）
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo npm i -g newman

常见排错：
- 报告未生成：检查测试框架是否输出到指定目录，确认 Jenkins 工作空间权限。

ls -l target/surefire-reports/

覆盖率解析失败：HTML 结构变化导致脚本抓取失败，改用 XML 解析：

# 解析 Jacoco XML 覆盖率
grep -o 'counter type="INSTRUCTION".*covered="[^"]*".*missed="[^"]*"' target/site/jacoco/jacoco.xml

接口测试网络超时：确认测试环境服务可达、DNS/代理设置正确：

curl -I http://test-api:8080/health

练习：
1. 将现有 Jenkinsfile 增加“静态扫描+质量门禁”两个阶段，并设置覆盖率阈值 75%。
2. 为某个接口测试集合（Postman）生成 JUnit 报告并在 Jenkins 中展示趋势。
3. 模拟一次门禁失败（覆盖率不足），验证流水线自动中止并输出原因。
4. 将 E2E 测试改为夜间构建触发，提交时仅运行单元测试。