技能介绍

为什么需要这个技能

日常 Spring Boot 开发中，框架层的隐性陷阱往往比业务逻辑更耗时。从 javax.* 到 jakarta.* 的迁移导致启动失败，@Transactional 自调用失效让事务静默回滚，@Async 默认线程池在高并发下打爆系统，这些不是 Java 语法问题，而是框架代理机制、生命周期和配置优先级的综合结果。

核心能力与工作机制

版本与边界探测：第一步先解析项目依赖（pom.xml / build.gradle）和代码导入，判定 SpringBoot 版本（2.7.x / 3.5.x / 4.x）、命名空间（javax.* vs jakarta.*）、是否 Web 项目、以及 ORM 和认证库的归属。
本地化知识路由：所有知识沉淀在本地 references/，运行时不依赖外部文档站点。决策路由表将框架层需求映射到 12 个主题文档（三层架构、配置、校验、异常、事务、异步、定时、事件、依赖注入、条件装配、SpringDoc、隐性陷阱合集）。
关键决策检查点：命中多路线场景（全局异常返回体格式、事务传播行为、事件触发时机、配置读取方式、循环依赖解法）时，先向用户确认方向，不擅自选择。
代码审查护栏：检测到 @Validated 分组校验不触发、@ExceptionHandler 父类吞子类、@Scheduled 默认单线程串行等高频误用时主动提醒。

适用边界

只处理框架层：Controller / Service / 配置 / 校验 / 异常 / 事务 / 异步 / 定时 / 事件 / 自动装配。不越界处理 ORM（→ mybatis-plus-dev）、Java 语言层（→ java-coding-guide-pro）、单测（→ java-unit-test）、集成测试（→ java-integration-test）。认证鉴权：项目已用 Sa-Token → sa-token-dev；否则本技能提供 HttpSession / ThreadLocal 最小方案。