Spring Boot 4.1.1升级实录 五类兼容陷阱致联调异常

Forge Admin项目在从Spring Boot 3.5.x升级至4.1.1过程中，虽Maven构建全绿、本地打包成功，但联调阶段频现金额字段解析异常、脱敏逻辑失效、超大JSON请求未拦截、ServiceImpl实例化失败及Flowable流程引擎异常等问题。根本原因在于Spring Boot 4对默认契约与依赖边界进行了结构性调整。首要问题是Jackson默认版本由2升至3，导致依赖Jackson 2定制序列化的加解密模块与需Jackson 3的MCP通信SDK共用ObjectMapper时行为冲突，金额字段被截断、脱敏策略不稳定；解决方案为分栈隔离：业务层强制使用Jackson 2并配置flowable.variable-json-mapper为jackson2, MCP层单独注入带@Qualifier的Jackson 3 JsonMapper。其次，Tomcat对请求体大小的隐式限流机制弱化，超大JSON（>10MB）绕过拦截直入业务层，引发OOM风险；团队补充自定义RequestBodyLimitFilter，并在application.yml中配置server.tomcat.max-http-form-post-size与spring.mvc.max-request-size双重限制。第三，MyBatis-Plus 3.5.17将mybatis-plus-spring拆为独立artifact，旧依赖声明导致@MapperScan路径不匹配，ServiceImpl无法实例化；修复方式为显式引入mybatis-plus-spring并校准mapper-locations与type-aliases-package。第四，Sa-Token 1.45在Boot 4下改用RedissonSession替代RedisSession，旧数据反序列化失败致登录态丢失；通过SaTokenDao桥接与一次性数据迁移脚本解决。第五，Flowable 8数据库Schema与7.x不兼容且无回滚工具，团队采用双库策略+flowable-migration-tool前向迁移，并手动注册ThreadPoolTaskExecutor以恢复异步任务调度。上述问题均为运行时行为漂移，非编译错误，凸显升级本质是默认语义重构。最终经T0–T6全量兼容测试验证，系统在协同Spring AI 2.0.1、Redisson 4.8.0等组件下稳定运行，经验表明升级前须厘清旧默认依赖、第三方库演进状态及可验证回归路径。