SuperAPI AI 工具集

spring-boot-knowledge-patch

编程与开发

查看项目

更新于 10-16 01:35

技能介绍

该技能用于在修改 Spring Boot 应用、库、starter、构建插件、测试、容器镜像或运维配置前,先核查相关主题参考文档,不要依赖旧的包名、默认值、属性键或扩展点。

使用方式:先判断受影响层次(构建/运行时、配置、Web、数据、安全、可观测性、测试、本地基础设施或 Spring AI),再从索引读取匹配的参考文件;跨层时可读多个,例如携带 OAuth 凭据的 HTTP 客户端或使用 SSL bundle 的数据客户端。先应用移除和重命名属性,再添加功能。重新核查影响暴露、重定向、代理信任、序列化、bean 选择、上下文传播或资源加载的默认值。版本敏感变通方案仅在参考文档明确限定于某版本时保留。

参考索引:configuration-and-container.md(属性绑定与导入、bean 选择、代理、任务、Docker Compose、服务连接);data-and-messaging.md(JDBC、JPA、MongoDB、Cassandra、Redis、Spring Data、Batch、JMS、Kafka、Pulsar、RabbitMQ);observability-and-operations.md(Actuator 访问、健康、SSL、结构化日志、Micrometer、OpenTelemetry、Prometheus);runtime-build-and-migration.md(平台要求、已移除 API、依赖、Gradle、Maven、原生镜像、Buildpacks);security.md(Security DSL 迁移、OAuth、JWT、MFA、WebAuthn、SAML、CSRF、LDAP、可信代理);spring-ai.md(BOM、advisors、RAG、memory、tools、evaluation、可观测性、MCP);testing.md(MockMvc、RestTestClient、上下文生命周期、bean 覆盖、Testcontainers、HtmlUnit、Spock);web-and-http-clients.md(MVC、WebFlux、Jackson、HTTP 客户端、API 版本、路由、绑定、cookie、Gateway)。

主要破坏性变更:使用 jakarta.annotation 与 jakarta.inject;面向 Jakarta EE 11 兼容 Web 容器;Undertow 仅在有兼容实现时视为 servlet-only;升级前检查构建工具下限;使用托管 jOOQ 线时要求 Java 21。替换 ListenableFuture、OkHttp 3 集成、主题支持、JUnit 4 TestContext、旧 MVC XML;RestTemplate 转向 RestClient 或 HTTP 服务接口;HttpHeaders 不再作 MultiValueMap;Hibernate 原生集成移至 org.springframework.orm.jpa.hibernate;Security 用 authorize 替换 check,移除 DSL and(),使用 PathPatternRequestMatcher;用 jar tools 模式替代 layertools。Jackson 3 中实现类移至 tools.jackson,注解仍在 com.fasterxml.jackson;用 JsonMapper.builder() 等构建 mapper。RestClient.retrieve() 必须以终止响应操作收尾。网关在配置可信代理正则前不要信任转发头。Actuator 端点访问需显式配置为 none、read-only 或 unrestricted,仅暴露不等于授权。新特性包括:@EnableResilientMethods 启用 @Retryable 与 @ConcurrencyLimit,@ImportHttpServices 分组 HTTP 服务接口,Spring Data 可移植 Vector 类型,MongoDB 向量索引与 $vectorSearch,@RedisListener 端点发现,AssertJ 的 MvcTester、RestTestClient、DynamicPropertyRegistrar,Spring AI BOM 与 MCP starter 等。

最终检查:运行测试前搜索已移除或重命名的配置键;使用外部属性类型时验证生成的配置元数据;用集成测试验证重定向、代理、cookie、JSON 与安全行为;单独检查 Actuator 访问与 Web 暴露;迁移运行时提示后验证原生资源 glob 与反射提示;检查容器镜像构建器假设,最小构建器可能不含 shell。原文未提供安装命令、收费方式或具体版本号,暂未提供。