Boot过程与MP测验结果封装

在Spring Boot项目启动时MyBatis-Plus往往会执行一系列数据库映射与自定义SQL测试。者常见的痛点是：如何将测试结果以统一结构返回给前端？还有测试失败后异常信息被吞没，导致调试困难。

Result包装统一化

所有Controller方法都应返回Result对象。以保证前端总能收到{code,msg,data}三字段。

@RestController
@RequestMapping
public class TalentController {
@Autowired
private TalentService talentService;@PostMapping
public Result save {
talentService.save;return Result.success;}
@GetMapping
public Result getById {
TalentDTO dto = talentService.getById;if {
return Result.error;}
return Result.success;}
}

MPSQL测验结果包装

MPSQL自带@Select/@Insert/@Update/@Delete注解时一旦SQL执行失败。框架只会抛出NoSuchMethodException/SqlException,而非业务级错误。为此建议的观点是，

• 把异常捕获后包装为BusinessException或SystemException并抛出。
• Mappers中使用注解时尽量保持SQL短小；若复杂请拆分到XML，

全局异常处理与日志策略

分类痛点

User Pain Point: "在业务层抛出的自定义异常被直接打印到控制台，但前端却收到了堆栈日志". 这主要是因为全局异常处理器未配置或位置错误。

Mappers中的异常抛出示例

@Mapper
public interface TalentMapper extends BaseMapper{
@Select
List findByCityAndEducation String city,@Param String education);}

BusinessException.java

package com.example.demo.exception;public class BusinessException extends RuntimeException {
private final Integer code;public BusinessException{
super;this.code=code;}
public BusinessException{ this;不过，}
public Integer getCode{return code;怎么说呢，}
}

SystemException.java

package com.example.demo.exception;public class SystemException extends RuntimeException{
private final Integer code;private final boolean needAlert;public SystemException{
super;this.code=code;this.needAlert=needAlert;}
public SystemException{ this;}
public Integer getCode{return code;}
public boolean isNeedAlert{return needAlert;}
}

GlobalExceptionHandler.java

package com.example.demo.exception;@RestControllerAdvice
public class GlobalExceptionHandler {
private static final Logger log = LoggerFactory.getLogger;@ExceptionHandler
public Result handleBiz{
return Result.error,e.getMessage);}
@ExceptionHandler
public Result handleSys{
log.error,e);if){
alert)，// 发送钉钉/邮件等
}
return Result.error。"程序繁忙，请稍后再试");按理说，}
@ExceptionHandler
public Result handleUnknown{
log.error;alert)，return Result.error;}
private void alert{
log.warn;// 实际可接入公司微信/钉钉等
}
}

Pain Point: "在生产环境中出现了大量边缘服务超时但却触发了过多告警导致运维疲劳". 通过SystemExcpetion.needAlert标识即可区分主要链路与边缘功能。

SUnit 与接口契约验证实践

User Pain Point：缺乏单元测试覆盖导致接口回归失误。

• - @SpringBootTest + JUnit5：Create test类位于src/test/java，与主包保持一致。
• - 使用@Order指定执行顺序确保先插入再查询再删除。 话说回来，
• - 在@Transaction + @Rollback下验证数据确实写入。
• - 断言方式：assertNotNull / assertEquals / assertThrows 等，确保逻辑正确性。
• - F12抓包确认Response符合Result格式，否则说明全局异常未生效。说起来，
• - 当出现“500 Internal Server Error”但返回的是HTML页面时说明没有开启全局异常或方法不匹配。需要检查@ControllerAdvice位置是否在@SpringBootApplication所在包下.
• - 当查询返回空数组而不是null时要确保Mapper方法返回List而非单个实体；否则前端会误认为成功.
• - 测试数据污染问题，通过@Transactional自动回滚解决.
. java @SpringBootTest @TestMethodOrder class TalentServiceTest{ @Autowired TalentService service;@Test @Order void save{ service.save);assertTrue)，} @Test @Order void find{ var t=service.findById;assertNotNull;assertEquals);} @Test@Transactional@Rollback //保留数据做验证 void delete{ service.delete;assertFalse);} }

`Interceptor`配置与使用细节

User Pain Point: “登录Token校验后端返回400，却前端仍然收到旧页面”——原因是Interceptor内未手动写JSON导致BasicErrorController拦截。

• - **LoginInterceptor** 用于校验Token并写入统一JSON响应。不建议直接抛业务异常，因为拦截器运行于DispatcherServlet之前。
. java @Component public class LoginInterceptor implements HandlerInterceptor{ private boolean checkToken{return "admin_token_123".equals;} @Override public boolean preHandle throws IOException{ String token=req.getHeader;if){ res.setStatus;res.setContentType;res.getWriter.write;return false;} if){ res.setStatus;res.setContentType;res.getWriter.write;return false;} ThreadLocalUser.setUserId);// 示例操作，可选 return true;} // afterCompletion 清理ThreadLocal防止泄漏 @Override public void afterCompletionthrows Exception{ ThreadLocalUser.clear;} }
• - **WebMvcConfig** 注册拦截器，并设置放行方法；其实，注意不要拦截静态资源，否则页面无法访问。
. java @Configuration public class WebMvcConfig implements WebMvcConfigurer{ @Autowired LoginInterceptor loginInterceptor;@Override public void addInterceptors{ registry.addInterceptor .addPathPatterns .excludePathPatterns;} }
• - 若需多拦截器，可按先后顺序注册。每个都有自己的addPathPatterns/excludePathPatterns。
. java registry.addInterceptor) .addPathPatterns;registry.addInterceptor) .addPathPatterns .excludePathPatterns;
• - **方法匹配规则**：/books/*仅匹配一级子方法；/books/**匹配任意深度；避免*过度使用导致性能下降。
. *Pain point*: 对Ant风格方法不熟悉导致误放行敏感接口或误拦截公共资源。. ---

从关键来看。

• MPSQL测验结果必须用统一Result封装，并通过全局异常处理保证堆栈不泄露。
• `Business/​System` 异常分别对应业务提示和程序告警，通过`needAlert`区分主要链路与边缘功能。
• `@SpringBootTest`+JUnit5加上F12抓包可快速定位接口契约是否符合预期。
• `LoginInterceptor`必须手动写JSON，否则会被BasicErrorController覆盖成HTML页面导致前端报错信息混乱。
.