2. 环境准备：JDK、Maven/Gradle、Redis Server、Spring Boot 项目脚手架搭建

回归冒烟测试的执行依赖一套稳定、可复现的本地开发环境。本节将按照“运行时 → 构建工具 → 缓存中间件 → 项目骨架”的顺序，逐一完成环境安装与验证，确保后续所有测试用例能在统一基线之上运行。

2.1 环境清单与版本选型

为避免因版本差异导致的兼容性问题，下表列出本次课程推荐的最低版本及已验证的稳定组合。请严格参照此表进行安装。

2.2 JDK 安装与验证

以 JDK 17（Eclipse Temurin 发行版）为例，安装后需在终端执行以下验证命令：

# 检查 Java 版本
java -version

# 输出示例（应包含 "17.0.10" 或更高）
openjdk version "17.0.10" 2024-01-16 LTS
OpenJDK Runtime Environment Temurin-17.0.10+7 (build 17.0.10+7)
OpenJDK 64-Bit Server VM Temurin-17.0.10+7 (build 17.0.10+7, mixed mode, sharing)

# 检查 javac 编译器
javac -version
# 输出示例：javac 17.0.10

2.3 构建工具配置：Maven 与 Gradle 二选一

本课程同时提供 Maven 和 Gradle 两种构建脚本。请根据团队技术栈选择其一，并确保本地已安装对应工具。

2.3.1 Maven 配置要点

# 验证 Maven 版本
mvn -version

# 输出示例
Apache Maven 3.9.6 (bc0240f3c744d6b6ff327b3b5f9a9e2f5f5f5f5f)
Maven home: /opt/homebrew/Cellar/maven/3.9.6/libexec
Java version: 17.0.10, vendor: Eclipse Adoptium, runtime: /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home

在 ~/.m2/settings.xml 中建议添加阿里云镜像仓库，加速依赖下载：

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>central</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/central</url>
    </mirror>
</mirrors>

2.3.2 Gradle 配置要点

# 验证 Gradle 版本
gradle -version

# 输出示例
------------------------------------------------------------
Gradle 8.5
------------------------------------------------------------
Build time:   2024-01-30 16:58:16 UTC
Revision:     bd6b8c9b3c8b5c8b5c8b5c8b5c8b5c8b5c8b5c8b
Kotlin:       1.9.22
Groovy:       3.0.17
Ant:          Apache Ant 1.10.13
JVM:          17.0.10 (Eclipse Adoptium 17.0.10+7)
OS:           Mac OS X 14.3.1 aarch64

在 ~/.gradle/init.gradle 中配置阿里云仓库：

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/public' }
        mavenCentral()
    }
}

2.4 Redis Server 安装与启动

Redis 是缓存层的核心中间件。回归冒烟测试要求 Redis 在本地以非保护模式运行，并开启 AOF 持久化以便测试后数据清理。

2.4.1 安装方式对比

2.4.2 验证 Redis 可用性

# 启动后验证
redis-cli ping
# 应返回：PONG

# 检查基本读写
redis-cli set test:smoke "hello"
redis-cli get test:smoke
# 应返回："hello"

# 清理测试数据
redis-cli del test:smoke

2.5 Spring Boot 项目脚手架搭建

使用 Spring Initializr（start.spring.io）或 IDE 内置向导生成项目。以下为 Maven 项目的核心依赖配置：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.2</version>
        <relativePath/>
    </parent>

    <groupId>com.cache.smoke</groupId>
    <artifactId>redis-cache-smoke-test</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <name>Redis Cache Regression Smoke Test</name>

    <properties>
        <java.version>17</java.version>
    </properties>

    <dependencies>
        <!-- Web 支持，用于测试控制器 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!-- Redis 缓存与数据访问 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-redis</artifactId>
        </dependency>

        <!-- 缓存抽象层 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-cache</artifactId>
        </dependency>

        <!-- 健康检查与指标 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>

        <!-- 测试框架 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

2.6 环境依赖关系总览

下图展示了各组件在回归冒烟测试执行过程中的调用链路与数据流向：

2.7 脚手架验证：启动与健康检查

完成上述配置后，执行以下命令验证项目能否正常启动并连接 Redis：

# Maven 启动
mvn spring-boot:run

# 或 Gradle 启动
gradle bootRun

启动成功后，访问 Actuator 健康端点确认 Redis 连接状态：

curl http://localhost:8080/actuator/health

# 预期返回（Redis 状态为 UP）
{
  "status": "UP",
  "components": {
    "redis": {
      "status": "UP",
      "details": {
        "version": "7.2.4"
      }
    }
  }
}

2.8 环境就绪检查清单

在进入下一章之前，请逐项确认以下条目全部通过：

• JDK：java -version 输出 ≥ 17，且 JAVA_HOME 已正确设置。
• 构建工具：mvn -version 或 gradle -version 输出正常，且阿里云镜像已配置。
• Redis：redis-cli ping 返回 PONG，且 AOF 已开启。
• Spring Boot 项目：mvn spring-boot:run 启动无报错，/actuator/health 返回 redis: UP。
• 测试数据隔离：已确认测试用 Redis 实例不包含生产或其他环境数据。