罗罗编程学习记录
本页内容 展开查看

06.2.2.5 Web 层、校验与数据集成

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.2 Java Spring 生态 / 06.2.2 Spring Boot

本节要解决的问题

  • Controller 层如何组织统一响应、参数校验与全局异常?
  • 校验注解、绑定来源、类型转换在 MVC 链路中如何生效?
  • MyBatis / JPA / 多数据源 / 连接池在 Boot 中如何配置,事务管理器如何按数据源指定?

版本前提:Spring Boot 3.x / Java 17+,Validation 命名空间为 jakarta.validation.*。

06.2.2.5-001 如何设计统一响应与全局异常?

一句话结论

定义统一响应体 code/message/data/traceId;用 @RestControllerAdvice 分类处理校验异常、业务异常、权限异常、系统异常;HTTP 状态码表达传输语义,业务码表达业务结果,系统异常不返回堆栈。

概念解释

统一响应让客户端按固定结构解析;全局异常把分散在 Controller 里的 try-catch 收口。HTTP 状态码仍要正确(400/401/403/404/409/500),业务码放在 body 里,不能把所有异常都包成 200。

示例

public record ApiResult<T>(String code, String message, T data, String traceId) {
    public static <T> ApiResult<T> ok(T data) {
        return new ApiResult<>("0", "ok", data, TraceId.get());
    }
    public static <T> ApiResult<T> fail(String code, String msg) {
        return new ApiResult<>(code, msg, null, TraceId.get());
    }
}

常见误区

  • 业务失败也返回 HTTP 200:网关、监控、客户端重试策略依赖 HTTP 语义,状态码被污染后无法按协议处理。
  • 系统异常把堆栈返给前端:泄漏内部结构,应只记录日志并返回通用错误码。

追问

  • 为什么要区分 HTTP 状态码与业务码?状态码面向传输与框架语义,业务码面向产品错误分类,两者正交。
  • 参数校验异常如何统一收集?捕获 MethodArgumentNotValidException 与 BindException,从 BindingResult 提取字段错误。

06.2.2.5-002 Spring Boot 如何集成 MyBatis 与 JPA?

一句话结论

MyBatis 引 starter + @MapperScan 定位接口,XML/注解 SQL;JPA 引 data-jpa starter,实体与 Repository 由 Hibernate 实现;两者可混用,按查询复杂度与领域模型选择。

概念解释

自动配置按 classpath 装配 SqlSessionFactory/EntityManagerFactory 与连接工厂;MyBatis 侧重手写 SQL 与结果映射,JPA 侧重领域对象与托管状态。

示例

mybatis:
  mapper-locations: classpath:mapper/*.xml
  configuration:
    map-underscore-to-camel-case: true
    default-fetch-size: 100
@MapperScan("com.example.mapper")
@SpringBootApplication
public class Application { }
spring:
  jpa:
    hibernate:
      ddl-auto: validate
    show-sql: false
    properties:
      hibernate:
        format_sql: true
        jdbc.batch_size: 50

常见误区

  • 复杂统计 SQL 强行用 JPA 方法推导:可读性与性能都差,复杂查询用 @Query、QueryDSL 或 MyBatis。
  • 开启 MyBatis 二级缓存跨会话共享:脏数据风险高,默认关闭更稳妥。

追问

  • MyBatis 与 JPA 如何选?复杂 SQL、高性能调优用 MyBatis;领域模型简单、以 CRUD 为主用 JPA;同系统可按模块混用。
  • ddl-auto=validate 有什么用?启动时校验实体与表结构一致,不一致快速失败,不修改表结构。

06.2.2.5-003 多数据源如何配置?事务如何指定管理器?

一句话结论

每个数据源定义独立 DataSource、TransactionManager 与 SqlSessionFactory/EntityManagerFactory;@Primary 指定默认;@Transactional(transactionManager = "xxx") 按事务管理器绑定数据源;跨库事务走分布式方案。

概念解释

本地事务管理器与数据源一一对应。未显式指定时使用默认管理器;跨多个库的操作不是本地 ACID 事务,需要消息最终一致性或分布式事务协调器。

示例

@Configuration
public class DataSourceConfig {
    @Primary
    @Bean("orderDataSource")
    @ConfigurationProperties("spring.datasource.order")
    public DataSource orderDataSource() {
        return DataSourceBuilder.create().build();
    }

    @Bean("userDataSource")
    @ConfigurationProperties("spring.datasource.user")
    public DataSource userDataSource() {
        return DataSourceBuilder.create().build();
    }
}
@Transactional(transactionManager = "orderTransactionManager")
public void createOrder() { }

常见误区

  • 多个数据源只配一个事务管理器:非默认数据源的事务仍走默认管理器,连接回滚错乱。
  • 以为 @Transactional 能跨库提交:本地事务管理器不能跨数据源两阶段提交。

追问

  • 多数据源下 MyBatis 的 @MapperScan 怎么配?按包分流,每个 SqlSessionFactory 指定 basePackages,Mapper 接口归入对应包。
  • 动态数据源 AbstractRoutingDataSource 怎么实现?重写 determineCurrentLookupKey,从 ThreadLocal 取路由键,按键切换目标数据源。

06.2.2.5-004 @RestController 与 @Controller 有什么区别?

一句话结论

@Controller 返回视图名或配合 @ResponseBody;@RestController 是 @Controller + @ResponseBody,方法返回值直接写入响应体(JSON/文本)。

概念解释

MVC 链路中 HandlerMethodReturnValueHandler 按返回值处理:带 @ResponseBody 的方法走消息转换器序列化,否则走视图解析器。

示例

@RestController
@RequestMapping("/api/orders")
public class OrderController {
    @GetMapping("/{id}")
    public OrderVO get(@PathVariable Long id) { return service.get(id); }
}

常见误区

  • 页面渲染 Controller 误用 @RestController:返回值被当 body 写回,不解析视图。
  • REST 接口在方法上重复写 @ResponseBody:@RestController 已含,冗余但无害。

追问

  • 同控制器能否混合页面与接口?可以,方法级 @ResponseBody 覆盖类注解,但建议拆分职责。
  • 返回 JSON 用什么转换器?Jackson(MappingJackson2HttpMessageConverter)自动配置。

06.2.2.5-005 参数校验如何做?BindingResult 怎么接?

一句话结论

DTO 字段标注 JSR-303 注解,Controller 参数加 @Valid/@Validated;校验结果放入紧邻的 BindingResult,有错误时抛 MethodArgumentNotValidException 由全局处理器统一收集。

概念解释

校验发生在参数绑定之后、方法调用之前;约束注解在 DTO 字段上,@Valid 触发校验,错误收集到 BindingResult,未捕获时抛方法参数绑定异常。

示例

public record CreateOrderRequest(
    @NotNull Long userId,
    @Min(1) int count,
    @Email String contact) { }
@PostMapping
public ApiResult<Long> create(@Valid @RequestBody CreateOrderRequest req) { }

常见误区

  • 校验注解标在接口入参原始类型上:应标注在 DTO 字段;直接校验简单参数需方法级 @Validated。
  • 有 BindingResult 却抛异常:错误被 BindingResult 接住,全局异常处理器收不到,需在方法内判断或不接 BindingResult。

追问

  • 分组校验怎么做?@Validated(Create.class),注解标注分组,按场景启用不同约束组。
  • 嵌套对象校验?嵌套字段加 @Valid 触发级联校验。

06.2.2.5-006 @RestControllerAdvice 如何组织全局异常处理?

一句话结论

类上 @RestControllerAdvice 声明全局增强,方法用 @ExceptionHandler 按异常类型匹配;可按包路径、注解限定生效范围,返回统一响应与对应 HTTP 状态。

概念解释

全局异常处理器是 MVC 层的增强组件,按异常类型匹配方法;它在 Controller 抛出异常后、响应写出前统一转换为业务响应体。

示例

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(BusinessException.class)
    public ApiResult<Void> business(BusinessException e) {
        return ApiResult.fail(e.getCode(), e.getMessage());
    }

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ApiResult<Void> valid(MethodArgumentNotValidException e) {
        String msg = e.getBindingResult().getFieldErrors().stream()
            .map(f -> f.getField() + " " + f.getDefaultMessage())
            .findFirst().orElse("invalid param");
        return ApiResult.fail("400", msg);
    }
}

常见误区

  • 多个 Advice 顺序混乱:同类异常被错误处理器先捕获,需用 @Order 或包路径收窄范围。
  • 处理器吞掉异常不记日志:业务异常可记录,系统异常必须记录完整堆栈用于排查。

追问

  • 如何只对部分 Controller 生效?@RestControllerAdvice(annotations = RestController.class) 或 basePackages。
  • 未捕获异常兜底?最后加 @ExceptionHandler(Exception.class),返回 500 通用响应并记日志。

06.2.2.5-007 错误响应如何对接 RFC 7807 ProblemDetail?

一句话结论

Boot 3 内置 ProblemDetail(RFC 7807 问题详情):type/title/status/detail/instance 结构;可与全局异常处理器结合,替代自造错误体中的部分字段。

概念解释

ProblemDetail 是标准的 HTTP 错误响应格式,spring-boot-starter-web 提供自动支持;业务错误码可放扩展字段,状态码仍取 HTTP 语义。

示例

@ExceptionHandler(OrderNotFoundException.class)
public ProblemDetail notFound(OrderNotFoundException e) {
    ProblemDetail pd = ProblemDetail.forStatus(HttpStatus.NOT_FOUND);
    pd.setTitle("order not found");
    pd.setDetail(e.getMessage());
    pd.setProperty("traceId", TraceId.get());
    return pd;
}

常见误区

  • 完全用业务响应体替代标准字段:客户端与网关无法按标准识别错误类型。
  • status 写成业务码:ProblemDetail 的 status 是 HTTP 状态,业务标识放扩展字段。

追问

  • ProblemDetail 与 ApiResult 能否共存?可以:对外标准问题详情,内部业务码作为扩展字段;按团队规范统一。
  • 序列化格式?默认 application/problem+json,可配置消息转换器。

06.2.2.5-008 参数绑定来源有哪些?

一句话结论

路径变量 @PathVariable、请求参数 @RequestParam、请求头 @RequestHeader、Cookie @CookieValue、请求体 @RequestBody、表单对象直接绑定;不同来源由对应参数解析器处理。

对比

注解 来源 典型类型
@PathVariable URL 路径段 路径标识
@RequestParam 查询参数 / 表单字段 筛选、分页
@RequestHeader 请求头 版本、追踪
@RequestBody 请求体 JSON DTO
@CookieValue Cookie 会话标识
无注解 表单/对象属性绑定 普通表单

常见误区

  • 把 JSON body 字段用 @RequestParam 取:body 已由 @RequestBody 绑定,参数注解来源不匹配。
  • 路径变量名与参数名不一致:显式指定 @PathVariable("id"),避免编译后参数名丢失。

追问

  • 绑定到对象的属性名匹配规则?按属性名宽松匹配,支持转换器。
  • @RequestParam 默认必填吗?默认 required=true,可选时设 false 或给默认值。

06.2.2.5-009 类型转换器与格式化器如何注册?

一句话结论

简单类型转换由 ConversionService 完成;自定义实现 Converter/Formatter 并注册到 FormattingConversionService;枚举、日期、金额等解析规则集中管理。

概念解释

请求参数到方法参数的类型转换由 ConversionService 完成;自定义 Converter/Formatter 纳入该服务后,按类型自动解析字符串与目标对象。

示例

@Component
public class StringToOrderStatusConverter
        implements Converter<String, OrderStatus> {
    @Override
    public OrderStatus convert(String source) {
        return OrderStatus.valueOf(source.toUpperCase());
    }
}

常见误区

  • 每个 Controller 手写解析:规则分散,错误信息不一致。
  • 转换器抛运行期异常未处理:绑定阶段转成 400,错误消息要可读。

追问

  • Converter 与 Formatter 区别?Converter 通用类型转换;Formatter 面向字符串解析与打印(本地化)。
  • 注册方式?作为 Bean 自动纳入 Boot 自动配置的 ConversionService。

06.2.2.5-010 MyBatis-Plus 分页插件原理是什么?

一句话结论

分页拦截器在执行查询前改写 SQL:加 count 统计与分页 limit;插件按方言生成 SQL,避免手工拼接 limit 导致注入与方言差异。

概念解释

MyBatis 插件链拦截 StatementHandler/Executor,先执行 count 查询再执行分页查询;分页对象携带页码、页大小与总条数。

示例

@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
    MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
    return interceptor;
}

常见误区

  • 手写 limit 拼接用户输入:存在 SQL 注入风险,应走参数化与分页插件。
  • count 查询未优化:大表全表 count 慢,必要时手写统计 SQL。

追问

  • 分页大偏移问题?offset 越大扫描越多,深翻页用游标/主键范围查询。
  • 插件方言如何选?按实际数据库类型配置,否则分页 SQL 语法错误。

06.2.2.5-011 JPA N+1 问题如何识别与解决?

一句话结论

遍历关联实体时每条触发一次查询;用 @EntityGraph、join fetch 或 EntityGraph 注解在一次查询中带出关联;区分懒加载在事务内访问与会话外访问。

概念解释

N+1:1 次查主列表,再按每条关联对象各查一次。关联默认懒加载,在持久化上下文内访问触发代理加载;会话外访问抛懒加载异常。

示例

@EntityGraph(attributePaths = "items")
@Query("select o from Order o where o.user.id = :uid")
List<Order> findWithItems(Long uid);

常见误区

  • 把所有关联设 EAGER:一次性带出过多数据,列表查询性能差。
  • 在 Controller 层访问懒加载关联:持久化上下文已关闭,抛 LazyInitializationException。

追问

  • join fetch 与 @EntityGraph 区别?前者写在 JPQL 中;后者按注解动态决定抓取边。
  • 批量加载怎么配?@BatchSize 批量初始化关联集合,减少逐行查询。

06.2.2.5-012 JPA ddl-auto 生产环境取什么值?

一句话结论

生产用 validate(启动校验结构一致)或 none;表结构变更由迁移工具(Flyway/Liquibase)管理,禁止 update/create-drop。

对比

取值 行为 适用环境
none 不操作表结构 生产默认
validate 校验实体与表一致 生产可选
update 按实体增量改表 仅限本地
create-drop 启动建表、结束删表 测试

常见误区

  • 生产 update:隐式加列/改类型可能锁表、丢数据,且不可回滚。
  • 用 JPA 自动迁移替代版本化脚本:表结构变更无审计、不可复现。

追问

  • 迁移工具怎么配?Flyway/Liquibase 管理版本化脚本,启动时按版本执行。
  • 校验失败怎么办?启动快速失败,人工核对实体与表结构差异。

06.2.2.5-013 多数据源下事务管理器如何绑定?

一句话结论

为每个数据源构造 DataSourceTransactionManager(MyBatis/JDBC)或 JpaTransactionManager(JPA),@Transactional 通过 transactionManager 名称选择;默认管理器标 @Primary。

概念解释

事务管理器与数据源一一对应;声明式事务通过管理器名称选择绑定哪个数据源的连接,默认管理器由 @Primary 指定。

示例

@Bean
@Primary
public PlatformTransactionManager orderTransactionManager(DataSource orderDataSource) {
    return new DataSourceTransactionManager(orderDataSource);
}

@Bean
public PlatformTransactionManager userTransactionManager(DataSource userDataSource) {
    return new DataSourceTransactionManager(userDataSource);
}

常见误区

  • 两个管理器同名或未注册:注入时报唯一 Bean 缺失。
  • JPA 模块用 JDBC 管理器:实体持久化不被 JPA 事务管理,flush 行为错乱。

追问

  • 声明式事务如何切换管理器?@Transactional(value = "userTransactionManager")。
  • 跨管理器调用怎么保证一致性?本地事务不能协调,用最终一致或分布式事务框架。

06.2.2.5-014 AbstractRoutingDataSource 动态数据源如何实现?

一句话结论

继承该抽象类,把多个目标数据源放入 Map;重写 determineCurrentLookupKey 从 ThreadLocal 取路由键,解析到目标数据源;线程退出时清理 ThreadLocal。

概念解释

路由数据源是一个中介 DataSource,内部持有多个目标库,运行时按路由键把获取连接的请求转发到对应目标库;路由键通常存在 ThreadLocal。

示例

public class RoutingDataSource extends AbstractRoutingDataSource {
    @Override
    protected Object determineCurrentLookupKey() {
        return DataSourceContext.get();
    }
}
public final class DataSourceContext {
    private static final ThreadLocal<String> HOLDER = new ThreadLocal<>();
    public static void set(String key) { HOLDER.set(key); }
    public static String get() { return HOLDER.get(); }
    public static void clear() { HOLDER.remove(); }
}

常见误区

  • ThreadLocal 不清理:线程复用后路由键串到下一个请求,切错库。
  • 异步线程中直接继承路由:ThreadLocal 不传递,需显式把键传到子线程。

追问

  • 读写分离怎么做?按读/写键路由到主库/从库。
  • 路由数据源本身要不要 @Primary?它作为统一 DataSource 暴露,内部转发到目标库。

06.2.2.5-015 HikariCP 连接池关键配置怎么理解?

一句话结论

maximumPoolSize 是连接上限,connectionTimeout 是获取连接等待超时,idleTimeout/maxLifetime 控制空闲与最长存活;连接池大小要结合数据库容量与下游压测确定。

概念解释

连接池复用物理数据库连接,避免每次请求重建连接;池大小、获取超时、空闲与存活时间共同决定并发承载与连接有效性。

示例

spring:
  datasource:
    hikari:
      maximum-pool-size: 20
      connection-timeout: 3000
      idle-timeout: 600000
      max-lifetime: 1800000
      keepalive-time: 300000

常见误区

  • 池大小设成上千:数据库连接数成为瓶颈,等待与上下文切换上升。
  • max-lifetime 大于数据库侧空闲断连时间:拿到已被服务端关闭的连接,出现连接失效错误。

追问

  • 池满了请求会怎样?等待 connection-timeout,超时抛获取连接异常。
  • 如何监控池状态?Actuator 暴露 HikariCP 指标(活跃/空闲/等待连接)。

06.2.2.5-016 schema.sql / data.sql 初始化如何控制?

一句话结论

Boot 可执行 classpath 下的建表与数据脚本;生产环境默认谨慎执行,应改用迁移工具;脚本执行顺序与是否在 JPA 之后运行需显式配置。

概念解释

SQL 初始化脚本在数据源就绪后按约定执行,用于建表与基础数据;生产环境应由版本化迁移工具管理,脚本执行模式可配置为仅内嵌库或关闭。

示例

spring:
  sql:
    init:
      mode: embedded      # only embedded;生产用 never/迁移工具
      schema-locations: classpath:db/schema.sql
      data-locations: classpath:db/data.sql

常见误区

  • 生产靠 data.sql 灌基础数据:重复执行与版本管理问题,应走迁移脚本。
  • JPA ddl-auto 与 SQL 脚本同时改表:执行顺序不确定,结构冲突。

追问

  • 脚本失败会阻止启动吗?默认失败中断,可配置容错策略,但生产不建议。
  • 多数据库方言脚本怎么组织?按 profile 或目录区分方言文件。

06.2.2.5-017 分页查询如何防 SQL 注入?

一句话结论

分页参数经类型转换与边界校验,排序字段不能直接拼进 SQL;用参数占位符传值,排序白名单映射到合法列名。

概念解释

分页值(页码、页大小)可参数化,但排序方向与列名是 SQL 标识符不能预编译;必须用白名单映射,用户输入只能选择合法列。

示例

private static final Set<String> SORT_COLUMNS = Set.of("id", "create_time");

String sort = SORT_COLUMNS.contains(rawSort) ? rawSort : "id";
// 列名走白名单映射;值用 ? 占位符

常见误区

  • 把 sort/order 字符串直接拼接进 ORDER BY:参数化占位符不能用于标识符,构成注入面。
  • 页码与页大小不校验:负数或超大值导致异常扫描。

追问

  • MyBatis ${} 与 #{} 区别?#{} 预编译参数;${} 文本替换,仅用于白名单后的标识符。
  • 深分页方案?游标分页/主键范围,避免大 offset。

06.2.2.5-018 DTO 与实体为什么要分离?

一句话结论

外部接口用 DTO 表达契约,实体映射数据库表;分离后字段暴露可控、序列化不泄漏内部状态,变更数据库结构不直接影响 API 契约。

概念解释

实体承载持久化状态与关联;直接返回实体会把关联、懒加载、表字段一起暴露,序列化可能触发懒加载或泄露敏感列。DTO 由 VO/请求对象经映射转换。

常见误区

  • Controller 直接返回 @Entity:关联被序列化加载,敏感字段(密码、内部标记)外泄。
  • 请求体直接绑定实体:传入不该由客户端设置的字段(创建时间、状态),存在越权赋值风险。

追问

  • 映射工具怎么选?手写转换方法可控;MapStruct 编译期生成映射,避免反射开销。
  • DTO 分层?请求 DTO、响应 VO、内部领域对象按用途分开,不复用同一结构。

06.2.2.5-019 Web 拦截器与参数解析器如何注册?

一句话结论

实现 HandlerInterceptor 做前置/后置统一处理,实现 HandlerMethodArgumentResolver 注入自定义参数;通过 WebMvcConfigurer 的 addInterceptors/addArgumentResolvers 注册。

概念解释

WebMvcConfigurer 是 MVC 自定义入口:拦截器挂在处理器执行前后,参数解析器负责把自定义注解、类型转换为方法入参。

示例

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new TraceInterceptor())
                .addPathPatterns("/api/**");
    }
    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
        resolvers.add(new CurrentUserArgumentResolver());
    }
}

常见误区

  • 把通用逻辑写进 Filter 又写进 Interceptor:职责重叠,链路顺序要明确(Filter → Interceptor → Controller)。
  • 拦截器路径写错:excludePathPatterns 覆盖静态资源与健康检查端点。

追问

  • Filter 与 Interceptor 区别?Filter 在 Web 容器层,不感知 Spring MVC 处理器;Interceptor 在 MVC 层,能拿到 HandlerMethod。
  • 参数解析器与 @ModelAttribute 区别?解析器按自定义注解/类型注入;@ModelAttribute 绑定表单到对象。

06.2.2.5-020 统一 traceId 如何透传到响应与日志?

一句话结论

Filter/拦截器生成或透传 traceId,放入 MDC;日志 pattern 输出 MDC 字段;响应体与响应头写入同一 traceId,实现日志、请求、链路追踪关联。

概念解释

追踪标识在请求入口生成或透传,放入 MDC 供日志输出,同时写入响应头与响应体;异步与跨服务调用需要显式复制和传递该标识。

示例

@Override
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)
        throws IOException, ServletException {
    String traceId = Optional.ofNullable(((HttpServletRequest) req).getHeader("X-Trace-Id"))
            .orElse(UUID.randomUUID().toString());
    MDC.put("traceId", traceId);
    try {
        ((HttpServletResponse) res).setHeader("X-Trace-Id", traceId);
        chain.doFilter(req, res);
    } finally {
        MDC.clear();
    }
}
logging:
  pattern:
    level: "%5p [traceId=%X{traceId}]"

常见误区

  • 异步线程不复制 MDC:子线程日志丢失 traceId,需传递 MDC 上下文或用任务装饰器。
  • 响应头与 body 使用不同 ID:排查时无法关联,必须同源。

追问

  • 跨服务调用怎么透传?把 traceId 放入请求头,下游过滤器读取并覆盖本地生成值。
  • MDC 内存泄漏?请求结束必须 MDC.clear(),线程池复用场景尤其重要。