SPEC for 04.spring-backend/

Inherits from: ../SPEC.md Mode: append + override Updated: 2026-08-13


模块定位

Spring 生态 + 后端框架(Spring Boot / Spring Cloud / 微服务框架)。

从 L0 继承

  • G1-G6 通用评分维度
  • 11 类基础扫描规则
  • 命名约定 + commit 格式 + 互链规则

本模块规则

评估维度(追加 G 维度后)

# 维度 2 分 1 分 0 分
A1 源码级深度 有源码片段 + WHY 注释 有代码只解释 WHAT 无代码
A2 版本演进对比 有 Boot 2.x vs 3.x 对比 提及差异未展开 无版本
A3 ❌/✅ 反例对比 有正反例(自动配置陷阱) 只有正确用法 无对比
A4 参数调优表 有 actual config + 调优建议 有表无建议 无参数
A5 场景压测数据 有启动时间/内存/QPS 实测 有数字无场景 无数据

写作要求

  • 所有 Spring 示例注明 Boot/Spring Framework/Cloud 版本与关键依赖。
  • 自动配置、事务、连接池、序列化和异步边界须展示生效条件与常见陷阱。
  • 配置示例使用可复制的 YAML/Java 片段,并解释为什么选择该值。
  • 至少给出一个生产场景的启动时间、内存、吞吐或故障恢复观测结果。

子目录约定

  • 01-core/:IoC、AOP、事件、资源、事务与核心扩展点。
  • 02-boot/:自动配置、配置管理、打包、测试和 Actuator。
  • 02-web/:Web MVC/WebFlux、HTTP、参数校验与异常处理。
  • 03-cloud/:服务治理、配置中心、服务发现与云端集成。
  • 04-data/:Spring Data、数据访问、缓存与消息抽象。
  • 06-integration/:消息、批处理、远程调用与外部系统集成。
  • 07-observability/:指标、日志、链路追踪和健康检查。
  • 08-annotations/、09-security/:常用注解、认证授权与安全实践。