📚 课程目录第2章开发环境搭建

2. 开发环境搭建：JDK 17、Spring Boot 3.x、Maven/Gradle、IDE 配置

限流熔断参数的调优，必须建立在稳定、可复现的开发环境之上。本章将指导你完成从 JDK 到 IDE 的完整环境搭建，确保后续所有压测与调优实验的结果具备一致性与可信度。

2.1 技术选型与版本矩阵

本课程采用以下经过验证的版本组合，避免因版本不兼容导致的限流熔断行为异常：

组件	推荐版本	说明
JDK	17 LTS	支持密封类、模式匹配、Record 等特性，Spring Boot 3.x 官方基线
Spring Boot	3.2.x	内置虚拟线程支持，优化了限流熔断的线程模型
Spring Cloud	2023.0.x	与 Boot 3.2.x 对齐，集成 Resilience4j 2.x
构建工具	Maven 3.9+ / Gradle 8.5+	Maven 用于标准项目，Gradle 用于快速原型
IDE	IntelliJ IDEA 2024.1+	内置 HTTP Client、Profiler 插件，便于本地压测

版本对齐提示： 切勿使用 Spring Boot 2.x + JDK 21 的组合，其限流熔断的线程池隔离机制与 Boot 3.x 存在显著差异，调优参数无法直接复用。

2.2 JDK 17 安装与多版本管理

推荐使用 SDKMAN 或手动安装方式管理 JDK 版本，确保 JAVA_HOME 指向 JDK 17：

# 使用 SDKMAN 安装并切换（推荐）
sdk install java 17.0.10-tem
sdk use java 17.0.10-tem

# 验证
java -version
# 输出示例：openjdk version "17.0.10" 2024-01-16 LTS

常见陷阱： 如果系统同时存在 JDK 8/11，务必在 IDE 的 Project Structure 中显式指定 SDK 为 JDK 17。限流熔断的 Semaphore 隔离模式在 JDK 17 下性能提升约 15%，错误配置将导致压测数据失真。

2.3 Spring Boot 3.x 项目脚手架

使用 Spring Initializr 或 Maven 原型生成项目骨架。以下为 Maven 项目的核心依赖配置：

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

<properties>
    <java.version>17</java.version>
    <spring-cloud.version>2023.0.1</spring-cloud.version>
    <resilience4j.version>2.2.0</resilience4j.version>
</properties>

<dependencies>
    <!-- 核心限流熔断组件 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-circuitbreaker-resilience4j</artifactId>
    </dependency>
    <dependency>
        <groupId>io.github.resilience4j</groupId>
        <artifactId>resilience4j-spring-boot3</artifactId>
    </dependency>
    <!-- Actuator 用于运行时参数观测 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

2.4 构建工具配置要点

Maven 和 Gradle 在限流熔断场景下的配置差异主要体现在依赖解析和插件版本上：

配置项	Maven 3.9+	Gradle 8.5+
依赖管理	使用 `<dependencyManagement>` 统一版本	使用 `platform()` 或 BOM 导入
编译参数	`<parameters>true</parameters>` 保留参数名	`java { toolchain { languageVersion = JavaLanguageVersion.of(17) } }`
测试隔离	默认 fork 模式，避免限流状态污染	需显式配置 `forkEvery(1)`
Profiler 集成	通过 `maven-surefire-plugin` 传递 JVM 参数	通过 `jvmArgs` 直接配置

  调优建议： 在 pom.xml 或 build.gradle 中预先配置 JVM 参数 -XX:+UseZGC -Xms512m -Xmx512m，确保限流熔断压测时 GC 停顿不会干扰延迟指标。

2.5 IDE 配置与插件清单

IntelliJ IDEA 是推荐 IDE，以下配置可显著提升限流熔断参数的调试效率：

必备插件：
- Spring Assistant — 可视化查看 Bean 依赖与 AOP 切面顺序
- Resilience4j Metrics — 在 IDE 内实时显示熔断器状态、速率限制器指标
- JMH Plugin — 微基准测试支持，用于精确测量限流开销
运行配置：
- 设置 Active Profiles 为 dev，加载本地限流参数
- 启用 Allow parallel run，便于同时启动多个服务实例模拟集群限流
调试技巧：
- 在 CircuitBreaker 的 onError 回调处设置条件断点
- 使用 Evaluate Expression 动态修改 slidingWindowSize 参数

2.6 环境验证清单

完成搭建后，执行以下验证步骤，确保环境对限流熔断参数调优完全就绪：

JDK 验证： 运行 java -XX:+PrintFlagsFinal -version | grep UseZGC，确认 ZGC 已启用
Spring Boot 验证： 启动应用后访问 /actuator/health，确认返回 {"status":"UP"}
Resilience4j 验证： 调用 /actuator/circuitbreakers，确认默认熔断器状态为 CLOSED
IDE 验证： 在代码中设置断点，确认 Spring Boot 的 @CircuitBreaker 注解 AOP 代理生效

快速诊断： 如果 /actuator/circuitbreakers 返回 404，请检查 application.yml 中是否配置了 management.endpoints.web.exposure.include=*，并确认 spring-cloud-starter-circuitbreaker-resilience4j 依赖已正确引入。

2.7 本章小结

至此，你已搭建完成一个专为限流熔断参数调优设计的开发环境。核心要点回顾：

JDK 17 + Spring Boot 3.2.x 是调优实验的基线，版本偏差将导致参数效果不可比
Maven/Gradle 的编译参数和测试隔离配置直接影响压测结果的准确性
IDE 的 Profiler 和 Resilience4j 插件是运行时参数观测的关键工具
环境验证清单确保所有组件协同工作，避免后续调优时排查环境问题