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(),线程池复用场景尤其重要。