当使用@ControllerAdvice和@ExceptionHandler处理自定义异常（如ApiException）时，若异常未被捕获，通常并非逻辑错误，而是Spring扫描路径缺失或配置不当所致。本文详解正确实现方式及关键排查点。

本文详解为何@ControllerAdvice异常处理器未捕获自定义ApiException，核心原因在于组件扫描路径配置缺失或类路径未被Spring管理，并提供完整可运行的修复方案。

本文详解为何@ControllerAdvice无法捕获自定义ApiException，重点指出包扫描遗漏这一常见原因，并提供完整可运行的修复方案，包括正确继承、注解配置与验证方法。

即使后端仅返回JSON数据、前端由React独立渲染，只要请求经由Spring的@Controller或@RestController处理、业务逻辑交由Service层封装、数据模型由领域对象承载，整个架构仍符合MVC的核心思想——职责分离与协作。

SpringBoot应用在生产环境上传大于100MB的文件时出现503错误，且请求未到达控制器，根本原因常是multipart功能未显式启用——即使配置了大小限制，spring.servlet.multipart.enabled=true缺失会导致Tomcat拒绝解析multipart请求体，直接返回503。

本文探讨在HR数据同步场景中，如何设计高可读、易维护且符合Spring生态规范的对象有效性校验逻辑，对比链式hasLength判断与Assert异常捕获两种方式，并推荐基于BeanValidation的声明式校验方案。