《Spring Boot 高级》11.1 Spring Boot 4 的模块化重构
给出 Spring Boot 4 模块化重构的动因与全貌:从单一 spring-boot-autoconfigure 大 jar 拆成按技术划分的模块、根包与 starter 命名约定、starter 改名对照、Flyway/Liquibase 新增 starter,以及 Jackson 3 与 Jakarta EE 11 基线对依赖声明和 import 语句的实际影响。
category
给出 Spring Boot 4 模块化重构的动因与全貌:从单一 spring-boot-autoconfigure 大 jar 拆成按技术划分的模块、根包与 starter 命名约定、starter 改名对照、Flyway/Liquibase 新增 starter,以及 Jackson 3 与 Jakarta EE 11 基线对依赖声明和 import 语句的实际影响。
本节为图书服务建立生产可用的日志基线:讲清 SLF4J 门面与 Logback 实现的分工,以及为什么不要直接依赖 Log4j2 API;给出六个级别的选择依据与 logging.level.<包名> 的精确控制;解读 4.1.1 的真实启动日志;讲透 logging.file.name 与 path 的差别、轮转配置、4.1 的 Log4j 文件轮转与 logging.group 分组。
交代本书的读者对象、前置知识、六部分结构与章节依赖,列出 JDK 25、Maven 和终端的环境清单与真实版本输出,说明代码、输出、省略号和命令的书写约定,以及三种阅读路径、验证代码的具体方法、版本不一致时的排查顺序与本书刻意不覆盖的范围。
说明这套 Java 四卷本为什么从语言与平台写起、为什么用 library 项目贯穿、为什么选 JDK 25 LTS 作主线,以及它与本站《Spring Boot》三部曲和 Java 专题的分工;也交代本书刻意不写的内容、验证方式,以及四卷本各自的边界。
系统讲解 Testcontainers 集成测试:容器化测试的原理与 Ryuk 资源回收、GenericContainer 与专用模块(数据库/Kafka/Redis)、@Testcontainers 生命周期与单例复用、等待策略、Docker Compose 模块、Spring Boot @ServiceConnection 零配置注入,以及 CI 环境与并行测试实践。
系统讲解 Micrometer 可观测性:MeterRegistry 与 Counter/Gauge/Timer/DistributionSummary 四大计量器、标签与高基数陷阱、Spring Boot Actuator 自动埋点、@Timed/@Counted 注解、Observation API 统一指标与链路追踪、Prometheus 暴露与 exemplar,并附生产治理实践。
系统讲解 Spring Batch 批处理:Job/Step/Chunk 编程模型与 JobRepository 元数据表、ItemReader/Processor/Writer 组合、事务边界与提交间隔、重启续跑与失败重试跳过、本地与远程分区并行、Spring Batch 5 的 API 变化,以及生产监控与调优实践。
系统讲解 JPMS 模块系统:module-info.java 的 requires/exports/opens/provides 语义、模块路径与类路径的差异、自动模块与无名模块的兼容规则、拆分包冲突、jdeps/jlink/jmod 工具链,以及从 classpath 迁移到 module path 的分阶段策略与 Spring 生态的兼容取舍。
深入结构化并发与 Scoped Values:StructuredTaskScope 的 Joiner 模型与 JDK 版本演进、ShutdownOnFailure/ShutdownOnSuccess 语义、自定义 Joiner、ScopedValue 替代 ThreadLocal 的作用域传递、取消传播与虚拟线程固定问题,以及生产迁移与可观测性实践。
系统讲解 GraalVM Native Image 与 AOT 编译:封闭世界假设与可达性分析原理、native-image 与 Maven/Gradle 插件构建流程、Spring Boot 3 AOT 引擎与 RuntimeHints、反射与资源元数据配置、启动与内存实测对比,以及生产落地的常见坑与取舍。
从 CPU、延迟、内存三个问题域出发,用本机 JDK 21 实测的 jcmd 与 JFR 输出演示 VM.flags、GC.heap_info、Thread.print、GC.class_histogram 的读法,讲清 JFR 记录了什么、线程转储怎么找死锁、堆转储怎么拿与怎么分析,并给出 Arthas 类在线诊断工具的适用边界与风险。
给出生产级图书借阅服务的上线检查清单、金丝雀蓝绿滚动的适用条件、上线后必看的 RED 指标与业务指标、基于 SLO 的错误预算与燃烧率告警定法,以及代码、配置、特性开关、数据四类回滚的取舍,附向前兼容的数据库迁移写法、发布演练要点与事故复盘模板,最后收束全书。
从 Tracer/Span 门面为什么存在讲起,用本机 jar 核实的签名拆解一次 span 的生命周期,说明 ObservationHandler 链如何让一次观察同时产出指标与 span,对比 Brave 与 OpenTelemetry 两种桥接、MDC 日志关联、概率与限速采样的组合,以及 W3C traceparent 与 B3 的报文差异。
把 18.1 的架构决策落成代码:分层骨架与关键接口、跨模块契约与统一错误码、借阅上限的乐观锁加唯一约束兜底、借书事件的可靠投递,并把单元、切片、Testcontainers 集成与契约测试串成四层测试,最后给出本地起依赖到联调前端的可复现步骤。
从 MeterRegistry 注册表与 Meter.Id 的身份语义讲起,对比 Counter、Gauge、Timer、DistributionSummary 的取值差异,拆解 Observation 用低/高基数键值统一指标与追踪,说明 MeterFilter 改名、加标签、限基数的介入点,并落到 Prometheus 导出与 percentiles-histogram 对 P99 的影响。
把生产级图书借阅服务的功能性需求与非功能性需求翻译成一组可评审的架构决策记录(ADR):模块拆分、数据模型、同步与异步边界、缓存策略、多租户隔离方式与技术选型,逐条给出理由、代价与被否决方案,并附模块依赖图、需求追溯表、风险清单与容量预算粗算,作为后两节实现与上线的地基。
本节把结构迁移与数据初始化拆开:Flyway 管表结构,data.sql 管开发数据,并讲清 spring.sql.init.* 与 defer-datasource-initialization 的配合。随后按「公共脚本 + 方言脚本 + profile 覆盖 locations」组织多环境迁移,并说明生产不自动插测试数据、测试环境的迁移取舍,以及迁移该在应用启动时还是流水线独立步骤执行。
对比原生镜像的收益与代价:启动时间、常驻内存、镜像体积的量级与测量方法,构建慢、构建期内存高与无 JIT 导致的吞吐损失,说明哪类服务值得上、哪类不该上,理清与 CDS、AppCDS、Project Leyden 的关系,并给出从 JVM 模式迁移的检查清单与回滚策略。
JVM 参数不是越多越好,生产上真正该调的只有一小撮。本节用本机 JDK 21 实测默认值讲清 -Xms/-Xmx、容器里的 MaxRAMPercentage、OOM 现场转储、G1 的取舍与何时上 ZGC、-Xlog:gc* 统一日志写法、直接内存与线程栈,并给出可复现的查默认值方法。
讲清原生镜像封闭世界假设下反射、资源与动态代理为何失败,逐一核实 RuntimeHints 的五个子 hint、RuntimeHintsRegistrar 与 @RegisterReflectionForBinding 的声明方式,并对照 reflect-config.json 与新版 reachability-metadata.json,附排查命令。