上周有个读者私信我,说他照着某培训机构 2023 年的视频学 Spring Boot,跟着敲代码,第一课就起不来项目——报错信息密密麻麻,百度半天没结果。最后发现视频教的是 Spring Boot 2.7,他装的是 4.1。
这不是他笨。这是学 Spring 最经典的死法:拿旧地图走新路。
2026 年的 Spring 生态,正处在二十年来最大的一次换血期。我把最近一年的关键发布、踩坑实录和学习路径捋了一遍,写成这篇,希望能帮你省下那几十个小时瞎撞的时间。
先看懂地形图:现在到底是哪个”代”
很多人学 Spring 晕,首先是晕在版本号上。Spring Boot、Spring Framework、Spring Cloud、Spring AI,各跑各的版本,像一桌人各说各的话。
其实你只需要记住三条线:
主线已经换了。 2025 年 11 月,Spring Boot 4.0 和 Spring Framework 7.0 一起发布,这是一次”代际重置”:底层换到 Jakarta EE 11(javax 彻底进博物馆),Jackson 升到 3.x,JDK 底线从 8 抬到 17。接着 2026 年 6 月 10 日,Spring Boot 4.1 发布,带来了 gRPC 自动配置、HTTP 客户端 SSRF 防护、懒数据库连接这些实用功能。今年 11 月,4.2 也在路上了。
旧路正在封。 Spring Boot 3.5 的开源支持已经在 2026 年 6 月 30 日截止,Spring Framework 6.2 也在同一天 EOL。换句话说,你现在还在 2.x、3.x 老项目上养老可以,但新项目再选老版本,就是自己往坑里跳。
学习选哪个? 新手直接从 Spring Boot 4.1 学起,别碰 3.x 教程。JDK 用 17 或 21 都行。
别一上来就啃源码,先抓住”自动装配”这条线
我见过太多人学 Spring 的姿势是:买一本《Spring 源码深度解析》,从 BeanFactory 开始硬啃,三个月后直接放弃,转行了。
真没必要。Spring 的灵魂就一件事:IoC 容器替你管理对象的生死,自动装配替你接线。@RestController 写个接口就能跑,背后是一整套”条件判断 + 约定大于配置”的机制在干活。学习路线应该是:
第一周:用 Spring Initializr 起项目,写 Controller、Service、Repository 三层,把 CRUD 接口跑通。理解分层架构这张图就够了,别碰源码。
第二到四周:深入注解背后的机制——@Autowired 怎么找到 bean、@ConditionalOnClass 怎么决定配置类生不生效。这时再回头看自动装配源码,你会发现它像拆开一个早就摸熟的电饭煲,结构清清楚楚。
一个月后:学事务、AOP、缓存、消息。这些是面试和干活的高频区。
工具上,IntelliJ IDEA 的 Ultimate 版或者装了 Spring Tools 插件的 VS Code 都行。IDE 里能直接看到哪些 bean 被装配了、条件判断是否通过——这是学自动装配最直观的教具,别浪费。
2026 年的避坑清单:升级 4.x 的人都踩过什么雷
光会学还不够, Spring Boot 4 这代换代坑不少。我把社区里真实的踩坑记录挑几个最痛的讲:
坑一:deprecated 的债,4.1 一次性收走。 有开发者在 4.0 上跑着一堆 deprecation 警告没管,升 4.1 直接编译错误雪崩——4.0 里所有标记废弃的 API 在新版本全被删了。官方建议很明确:升 4.x 之前,先升到 3.5.x 最新版,把所有 deprecated 警告清零。
坑二:企业网里的”幽灵代理”。 4.1 里 Reactor 的 HTTP 客户端默认开始遵循系统代理参数。如果你的服务器基础镜像里设置了 http.proxyHost(很多公司镜像会设,设完就没人记得),升级后 WebClient 的调用会莫名其妙地走代理超时。排查方法就是看启动参数和 JAVA_TOOL_OPTIONS。
坑三:Dockerfile 里的 layertools 没了。 4.1 移除了 layertools 模式,分层构建的 Dockerfile 要从 -Djarmode=layertools 改成 -Djarmode=tools,构建命令也跟着变。有团队 CI 全挂在这个上面。
迁移的正确姿势是”分段跳”:3.4 → 3.5.x 最新 → 4.0 → 4.1,每段单独跑测试。第三方库(尤其是 Spring Cloud 这种 Boot 不管的版本)要单独核对兼容性。有 OpenRewrite 这样的自动化迁移工具,能批量做 javax→jakarta 的改名和 API 替换,几十上百个微服务升级时比人工靠谱得多。
新版本的红利:学对了,这些能力白捡
换代不只是折腾,4.x 这一代确实给了实打实的好东西。
数据库连接可以”懒”了。 以前一个方法标了 @Transactional,哪怕它只查了缓存根本没碰数据库,连接池也得掏一个连接出来干等着。4.1 加了一行配置 spring.datasource.connection-fetch= lazy,物理连接等到真正执行 SQL 时才取。对缓存命中率高的服务、开了虚拟线程的应用,连接池压力肉眼可见地降。
gRPC 成了一等公民。 以前要在 Spring 里用 gRPC,得靠第三方 starter,版本对齐常年打架。现在官方 starter 直接进 BOM,服务端、客户端、测试支持全套齐活。做内部服务通信的,该学起来了。
安全默认值变聪明了。 4.1 加了 InetAddressFilter,一个 bean 就能让 RestClient、WebClient 拒绝访问内网地址和云元数据接口(169.254.169.254),挡住 SSRF 攻击。以前这是要自己写连接器逐客户端配的体力活。
可观测性和 AI 是两条新赛道。 OpenTelemetry 的支持在 4.1 里大幅改进,环境变量直接配导出器;Spring AI 2.0 已经发布,把工具调用做成了框架级能力。学 Spring 的人如果还只盯着 MVC 和 JPA,过两年简历真的不好看。
写在最后
Spring 这东西,二十多岁了,每个版本都在”让你少写代码”和”让你多学概念”之间反复横跳。学它的秘诀从来不是背多少注解,而是跟上它的节奏:看清版本地形,抓牢自动装配这条线,升级时一段一段来。
框架会过时,但”把复杂留给自己、把简单留给使用者”的这套设计思想,你学会了就永远带得走。
你现在卡在哪个版本?评论区聊聊,说不定你踩过的坑,正是别人需要的答案。
参考来源:InfoQ《Spring Boot 4.1 Adds gRPC Auto-Configuration, SSRF Mitigation, and Kotlin 2.3 Support》、HeroDevs Spring Boot 版本支持周期表、Spring 官方 4.1 Release Notes、Moderne Spring Boot 4.x 迁移指南等公开资料。
