Web 与配置

5.1DispatcherServlet 请求生命周期

DispatcherServlet 是 Spring MVC 的前控制器——每个请求在这里被分派给正确的 Handler，再经消息转换器序列化为响应体。

请求路径从内嵌 Tomcat 的 Connector 开始。Connector 把原始 TCP 流解析为 HttpServletRequest，交给 DispatcherServlet.doDispatch()。

doDispatch 核心步骤：

1. getHandler()：遍历所有注册的 HandlerMapping（最常用的是 RequestMappingHandlerMapping），返回 HandlerExecutionChain（目标 handler + 拦截器链）。
2. getHandlerAdapter()：根据 handler 类型选择 HandlerAdapter，@RequestMapping 方法对应 RequestMappingHandlerAdapter。
3. HandlerAdapter.handle()：解析方法参数（@RequestBody 走 HttpMessageConverter 反序列化），调用 controller 方法，对返回值序列化（@ResponseBody 同样走 HttpMessageConverter）。
4. processDispatchResult()：若有 ModelAndView 则渲染视图（resolveViewName）；若已直接写入响应体则跳过。

5.2内嵌服务器（Boot 4.0）

Boot 4.0 的内嵌 Servlet 容器只剩 Tomcat（默认）和 Jetty；Undertow 已移除；响应式栈用 Netty。

机制回路指向 第 2 章 §2.3：ServletWebServerApplicationContext 在 onRefresh()（refresh 第 9 阶段）重写父类，调用 createWebServer() 建立 TomcatWebServer；此时 finishBeanFactoryInitialization（第 11 阶段，预实例化业务单例）尚未执行。内嵌服务器的启动早于绝大多数业务 Bean 的实例化。

切换到 Jetty 只需把 spring-boot-starter-web 中的 Tomcat 依赖排除，再引入 spring-boot-starter-jetty——自动配置的 JettyAutoConfiguration 在 WebServerFactoryCustomizer 接口下发现 Jetty 工厂并接管。

5.3Environment 与 PropertySource 优先级

Environment 是 profiles + properties 的抽象，内部维护一个有序的 PropertySource 列表——先命中的 PropertySource 赢。

ConfigurableEnvironment 在 run() 的 prepareEnvironment 阶段构建，由 ConfigDataEnvironmentPostProcessor 加载外部化配置文件并按优先级插入到 PropertySource 链。查询属性时，Environment 按顺序遍历链，第一个包含该 key 的 PropertySource 获胜——后续来源不再被查询。

优先级（从高到低）：

1. 命令行参数（--server.port=9090）
2. SPRING_APPLICATION_JSON（嵌入 JSON 的环境变量或系统属性）
3. OS 环境变量（如 SERVER_PORT）
4. application-{profile}.yml（激活的 profile 特定文件）
5. application.yml（默认配置文件）
6. @PropertySource 注解导入的文件
7. SpringApplication 默认属性

5.4@ConfigurationProperties 绑定与 relaxed binding

ConfigurationPropertiesBindingPostProcessor 用 Binder 把前缀下的所有属性绑到 POJO，支持 relaxed binding；@Value 是逐字段 SpEL 求值，无 relaxed binding。

Binder 的归一规则：把属性名统一转为 canonical form（小写 + 短横线），再匹配 POJO 字段。MY_APP_PORT → my-app.port，与 @ConfigurationProperties(prefix="my.app") 的 port 字段匹配成功。

@Value("${my.app.port}") 则是精确字符串匹配——它直接查询 Environment，Key 必须完全等于 my.app.port，OS 环境变量 MY_APP_PORT 在 Environment 里以原始大写 key 存储，查询 my.app.port 时找不到，绑定失败（返回默认值或抛出 IllegalArgumentException）。

@ConfigurationProperties(prefix = "my.app")
@Validated
public class MyAppProperties {

    /** relaxed binding: my.app.port / MY_APP_PORT / myApp.port 都能绑到这里 */
    @Min(1) @Max(65535)
    private int port = 8080;

    @NotBlank
    private String name;

    @DurationUnit(ChronoUnit.SECONDS)
    private Duration timeout = Duration.ofSeconds(30);

    // getters & setters (或用 record — Boot 4.0 支持)
    public int getPort() { return port; }
    public void setPort(int port) { this.port = port; }

    public String getName() { return name; }
    public void setName(String name) { this.name = name; }

    public Duration getTimeout() { return timeout; }
    public void setTimeout(Duration timeout) { this.timeout = timeout; }
}

@SpringBootApplication
@EnableConfigurationProperties(MyAppProperties.class)  // 或在类上直接加 @Component
public class App {
    public static void main(String[] args) {
        SpringApplication.run(App.class, args);
    }
}

Boot 4.0 中 jakarta.validation.*（如 @NotBlank、@Min）替代旧 javax.validation.*，需引入 spring-boot-starter-validation。校验失败在容器启动时即报 BindValidationException，而非首次注入时才发现。

5.5OSIV 陷阱

Open Session in View 默认把 Hibernate EntityManager session 开到整个 HTTP 请求周期——代价是掩盖 N+1 并在 WARN 日志里静默失败。

OSIV（spring.jpa.open-in-view=true）由 OpenEntityManagerInViewInterceptor（或 OpenEntityManagerInViewFilter）实现：在请求进入时绑定 EntityManager 到当前线程，在响应返回后关闭。由于 session 在 controller 和视图层都处于打开状态，lazy 关联（@OneToMany(fetch=LAZY)）被访问时能透明触发额外 SELECT——**不会**抛 LazyInitializationException。

失败模式的隐蔽性在于：当 controller 返回包含懒关联的实体列表，Jackson 序列化过程中逐个访问每条记录的关联集合，每次触发一条 SELECT——100 条记录产生 100 条额外查询。这一行为在 OSIV 开启时完全静默，只有在慢查询日志或 Hibernate statistics 里才能观察到。

修复路径：关闭 open-in-view=false，在 Service 层使用 JOIN FETCH JPQL、@EntityGraph、或 DTO 投影显式抓取所需关联，让数据获取意图在代码里可见。

spring:
  jpa:
    open-in-view: false   # 关闭 OSIV，强制显式抓取
  datasource:
    url: jdbc:postgresql://localhost:5432/mydb

public interface OrderRepository extends JpaRepository<Order, Long> {

    // JOIN FETCH 显式抓取 items，避免 N+1
    @Query("SELECT o FROM Order o JOIN FETCH o.items WHERE o.userId = :userId")
    List<Order> findWithItemsByUserId(@Param("userId") Long userId);

    // 或用 @EntityGraph 声明式指定
    @EntityGraph(attributePaths = {"items", "items.product"})
    List<Order> findByUserId(Long userId);
}