微服务电商项目 mall4cloud 暌违已久，直接甩出一个大版本——从 Spring Boot 3.x 跳到 4.x，Spring Cloud 从 2024 拉到 2025，连 Nacos、Seata、Spring Cloud Alibaba 全线跟进。这不是小修小补，而是整条技术栈的代际升级。
核心依赖版本一览
先把关键变更摊开看：
| 组件 | 旧版本 | 新版本 |
|---|---|---|
| Spring Boot | 3.x | 4.x |
| Spring Cloud | 2024.0.1 | 2025.1.1 |
| Spring Cloud Alibaba | 2023.0.3.3 | 2025.1.0.0 |
| Nacos | 2.4.3 | 3.1.1 |
| Seata | 2.0.0 | 2.6.0 |
| MyBatis Spring Boot Starter | — | 4.0.1 |
几个值得关注的点：
- Nacos 3.x 是一次架构级重构，对 gRPC 和长连接模型做了大幅调整，配置中心与注册中心的 API 也有变化。如果你之前用的是 2.x 客户端，直接换 3.x 服务端会遇到协议兼容问题，必须同步升级客户端依赖。
- Seata 2.6.0 相比 2.0.0 修复了大量分布式事务边界场景的 bug，AT 模式的 undo log 处理更稳健，对 Spring Boot 4 的自动装配也做了适配。
- Spring Cloud Alibaba 2025.1.0.0 是专门为 Spring Cloud 2025.x 定制的版本，Nacos、Seata、Sentinel 的 starter 全部重写了自动配置类，旧版的
spring.cloud.alibaba属性前缀部分已废弃。
Spring Boot 4 带来了什么
Spring Boot 4 基于 Spring Framework 7，最实质的变化集中在三块：
- Jakarta EE 11 基线——
jakarta.servlet、jakarta.persistence等包版本再往上走了一级。如果你项目里还有javax.*的残留引用，这次必须彻底清理。 - 虚拟线程（Virtual Threads）正式默认启用——Tomcat、Undertow 等嵌入式容器在处理请求时默认使用 Loom 虚拟线程，IO 密集型微服务的吞吐量会有明显提升，不再需要手动配置
spring.threads.virtual.enabled=true。 - AOT 编译增强——GraalVM native image 的支持更成熟，启动时间从秒级压到毫秒级，适合函数式部署和冷启动敏感场景。
对 mall4cloud 这种电商系统来说，虚拟线程是最直接的性能红利——订单查询、库存校验这类高 IO 操作，在同样硬件条件下吞吐量可以提升 30%–50%（具体数值取决于业务逻辑中的阻塞比例）。
实操：快速跑起 mall4cloud 4.0
下面给出一个最小化启动流程，假设你本地已有 Docker 和 JDK 21+ 环境。
1. 拉取项目并确认版本
git clone https://github.com/mall4cloud/mall4cloud.git
cd mall4cloud
git checkout v4.0
# 确认根 pom 中的核心版本
grep -E "spring-boot|spring-cloud|nacos|seata" pom.xml | head -10
2. 用 Docker Compose 一键启基础设施
mall4cloud 4.0 需要的中间件版本和旧版不同，尤其是 Nacos 3.x 不能用旧镜像。项目里已提供了更新后的 compose 文件：
cd docker
docker compose up -d
如果你想手动控制，核心服务可以这样写（保存为 infra-compose.yml）：
version: "3.8"
services:
nacos:
image: nacos/nacos-server:v3.1.1
container_name: nacos
environment:
- MODE=standalone
- JVM_XMS=512m
- JVM_XMX=512m
ports:
- "8848:8848"
- "9848:9848" # gRPC 端口，3.x 必须开放
restart: always
seata:
image: seataio/seata-server:2.6.0
container_name: seata
ports:
- "8091:8091"
depends_on:
- nacos
restart: always
mysql:
image: mysql:8.0
container_name: mysql
environment:
- MYSQL_ROOT_PASSWORD=root
ports:
- "3306:3306"
restart: always
redis:
image: redis:7.2
container_name: redis
ports:
- "6379:6379"
restart: always
docker compose -f infra-compose.yml up -d
注意：Nacos 3.x 的 gRPC 端口
9848必须映射出来，否则 Spring Cloud Alibaba 2025 的客户端无法连接注册中心。
3. 修改本地配置并启动微服务
在 application.yml 中确认 Nacos 地址和 Seata 注册方式：
spring:
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
config:
server-addr: 127.0.0.1:8848
# Alibaba 2025.x 中 seata 的配置前缀已变更
alibaba:
seata:
tx-service-group: mall_tx_group
seata:
service:
vgroup-mapping:
mall_tx_group: default
registry:
type: nacos
nacos:
server-addr: 127.0.0.1:8848
namespace: public
group: SEATA_GROUP
然后按顺序启动各服务：
# 先启动网关和基础服务
mvn spring-boot:run -pl mall4cloud-gateway
mvn spring-boot:run -pl mall4cloud-auth
# 再启动业务服务
mvn spring-boot:run -pl mall4cloud-order
mvn spring-boot:run -pl mall4cloud-product
如果你用的是 JDK 21+，虚拟线程默认生效，无需额外配置。想验证是否真的在用虚拟线程，可以加一行临时日志：
// 在任意 Controller 方法中插入
log.info("当前线程: {}, 是否虚拟线程: {}",
Thread.currentThread().getName(),
Thread.currentThread().isVirtual());
启动后调用任意接口，日志中出现 true 即确认生效。
升级路上的坑与建议
如果你不是从 mall4cloud 模板起步，而是要把自己的微服务项目升到同一套版本，需要留意以下几点：
Nacos 客户端与服务端必须同版本
Nacos 3.x 的 gRPC 协议与 2.x 不兼容。服务端升到 3.1.1 后，所有微服务的 nacos-client 依赖也要换到对应版本，Spring Cloud Alibaba 2025.1.0.0 已经内置了匹配的客户端，不需要单独声明。
Seata 的 undo log 表结构可能需要迁移
从 2.0.0 到 2.6.0，undo_log 表的字段有微调（增加了 branch_type 列的默认值约束）。如果你的数据库里已有旧数据，建议先备份，再执行 Seata 官方提供的 SQL 迁移脚本。
Jakarta EE 11 的包路径
Spring Boot 4 强制要求 jakarta.* 命名空间。第三方依赖如果还在用 javax.servlet、javax.validation，要么升级依赖版本，要么用 Tomcat EL 兼容桥接——但长远来看必须换掉。
MyBatis Starter 4.0.1 的变化
mybatis-spring-boot-starter 4.x 移除了对 mybatis-spring 的自动版本管理，如果你之前显式声明了 mybatis-spring 的版本，现在可以删掉，让 starter 自己管。另外，MapperScan 的默认注入行为有调整，自定义 SqlSessionFactory 时注意别覆盖自动配置。
mall4cloud 4.0 这一波升级，本质上是把整条微服务技术栈拉到了 2025 年的最新基线。对新项目来说，直接用 4.0 起步是最省力的选择；对存量项目，建议先在隔离环境里把 Nacos 和 Seata 单独升级验证，再整体切换 Spring Boot / Cloud 版本——中间件先行，框架跟进，最后改业务代码里的包路径，这样回滚成本最低。