Controller 如何瘦身 70%？这 5 招试过没？

开发过Spring Boot项目的工程师都经历过这样的场景——随着业务迭代，Controller层逐渐膨胀成近千行的”庞然大物”，参数校验、业务逻辑、异常处理代码纠缠不清。这种臃肿的控制器不仅维护困难，还会引发接口响应变慢、事务管理复杂等问题。今天分享5个实战技巧，教你像外科手术般精准剥离冗余代码，实现Controller层代码量锐减70%。

传统参数校验需要手动编写大量if判断：

if(StringUtils.isEmpty(request.getName())) {
    throw new Exception("姓名不能为空");
}
if(request.getAge() < 18) {
    throw new Exception("年龄不合法"); 
}

改用@Validated + Validation注解后：

public class UserDTO {
    @NotBlank(message = "姓名不能为空")
    private String name;
    
    @Min(value = 18, message = "年龄需满18岁")
    private Integer age;
}

@PostMapping
public Result createUser(@RequestBody @Valid UserDTO dto) {
    // 校验通过后直接执行业务
}

配合@ControllerAdvice统一处理校验异常，避免每个Controller重复编写异常处理逻辑。

接收请求参数
调用Service方法
返回封装结果

改造前改造后

改造前	改造后
`@PostMapping("/order") public Result createOrder(OrderVO vo) { // 参数校验（200行） // 库存检查（150行） // 优惠计算（300行） // 订单生成（200行） }`	`@PostMapping("/order") public Result createOrder(@Valid OrderDTO dto) { return orderService.create(dto); }`

@PostMapping("/order")
public Result createOrder(OrderVO vo) {
    // 参数校验（200行）
    // 库存检查（150行） 
    // 优惠计算（300行）
    // 订单生成（200行）
}

@PostMapping("/order") 
public Result createOrder(@Valid OrderDTO dto) {
    return orderService.create(dto);
}

使用@Around注解统一处理接口日志：

@Aspect
public class LogAspect {
    @Around("@annotation(org.springframework.web.bind.annotation.PostMapping)")
    public Object log(ProceedingJoinPoint joinPoint) {
        // 记录请求参数
        Object result = joinPoint.proceed();
        // 记录响应结果
        return result;
    }
}

通过自定义注解实现接口权限控制：

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface AuthCheck {
    String[] roles() default {};
}

@AuthCheck(roles = {"admin"})
@GetMapping("/users")
public Result getUserList() {
    // 方法执行前自动校验权限
}

@Mapper
public interface UserConverter {
    UserConverter INSTANCE = Mappers.getMapper(UserConverter.class);
    
    @Mapping(source = "registerDate", target = "createTime")
    UserVO toVO(UserEntity entity);
}

// 使用示例
UserVO vo = UserConverter.INSTANCE.toVO(entity);

方案	10000次转换耗时
手动set	15ms
BeanUtils	220ms
MapStruct	8ms

/user
  ├── UserBasicController   // 基础信息
  ├── UserAuthController    // 认证相关
  └── UserLogController     // 操作日志

@RestController
@RequestMapping("/api/v1/products")
public class ProductV1Controller {}

@RestController  
@RequestMapping("/api/v2/products")
public class ProductV2Controller {}

某电商项目优化前后对比：