Spring Boot 2.7 -> 3.5 升级

按固定阶段执行，优先保证可编译、可启动、可回归。

快速入口

1. 先读 references/upgrade-checklist.md，确定环境与迁移顺序。
2. 再读 references/dependency-replacement-matrix.md，按坐标替换依赖。
3. 执行 references/pitfall-cookbook.md 的代码级坑点改造。
4. 若父 POM 是 bw-spring-boot-starter-parent-security，执行 references/enterprise-parent-security.md。

执行阶段

1) 基线准备

• 统一 JDK 21、Maven 3.9+。
• 建立升级分支并记录当前编译状态。
• 识别启动入口模块（通常 *-startup）。