---

name: springboot-verification description: Spring Boot 项目的验证循环：构建、静态分析、测试与覆盖率、安全扫描，以及在发布或 PR 前的差异审查。

Spring Boot 验证循环

在 PR 前、重大变更后、部署前执行。

阶段 1: 构建

mvn -T 4 clean verify -DskipTests
# 或者
./gradlew clean assemble -x test

如果构建失败，则停止并修复。

阶段 2: 静态分析

Maven（常用插件）:

mvn -T 4 spotbugs:check pmd:check checkstyle:check

Gradle（如果已配置）:

./gradlew checkstyleMain pmdMain spotbugsMain

阶段 3: 测试 + 覆盖率

mvn -T 4 test
mvn jacoco:report   # 确认覆盖率在 80% 以上
# 或者
./gradlew test jacocoTestReport

报告:

• 测试总数、通过/失败数
• 覆盖率%（行/分支）

阶段 4: 安全扫描

# 依赖项的 CVE
mvn org.owasp:dependency-check-maven:check
# 或者
./gradlew dependencyCheckAnalyze

# 密钥（git）
git secrets --scan  # 如果已配置

阶段 5: Lint/格式化（可选门控）

mvn spotless:apply   # 如果使用 Spotless 插件
./gradlew spotlessApply

阶段 6: 差异审查

git diff --stat
git diff

检查清单:

• 没有残留的调试日志（System.out、无保护的 log.debug）
• 有意义的错误信息和 HTTP 状态码
• 在必要的地方有事务和验证
• 配置变更已文档化

输出模板

验证报告
===================
构建:     [通过/失败]
静态分析:   [通过/失败] (spotbugs/pmd/checkstyle)
测试:     [通过/失败] (X/Y 通过, Z% 覆盖率)
安全扫描: [通过/失败] (发现 CVE: N)
差异:       [X 个文件变更]

总体:       [就绪 / 未就绪]

需要修复的问题:
1. ...
2. ...

持续模式

• 如果有重大变更，或在长时间会话中，每 30~60 分钟重新运行阶段
• 保持短循环：mvn -T 4 test + spotbugs 以获得快速反馈

注意：快速反馈胜过缓慢的意外。保持门控严格，在生产系统中将警告视为缺陷。