Spring Boot(Kotlin)应用DTO集合验证与错误展示异常排查

一、DTO集合验证问题修复 #

1. 集合内DTO属性验证失效 #

• 确保集合字段同时标注@Valid和集合校验注解（如@NotEmpty），Kotlin中必须使用@field:前缀指定字段级验证：

  data class CreateProjectRequest(
      @field:NotEmpty(message = "任务列表不能为空")
      @field:Valid // 触发集合内DTO的嵌套验证
      val tasks: List<TaskDTO>
  )
  
  data class TaskDTO(
      @field:Size(min = 3, max = 50, message = "任务标题长度需在3-50字符之间")
      val title: String,
      @field:Size(max = 200, message = "任务描述不能超过200字符")
      val description: String?
  )
  

• 控制器类上添加@Validated注解，开启方法级验证支持，方法参数使用@Valid修饰请求对象：

  @Validated
  @Controller
  class ProjectController {
      @PostMapping("/create")
      fun createProject(@Valid request: CreateProjectRequest, ...) {
          // 业务逻辑
      }
  }
  

2. 普通Controller无验证效果/表单提交仅刷新页面 #

• 普通Controller（非@RestController）必须显式注入BindingResult参数捕获验证错误，否则Spring会默认重定向：

  @PostMapping("/projects")
  fun submitProject(
      @Valid request: CreateProjectRequest,
      bindingResult: BindingResult,
      model: Model
  ): String {
      // 检查是否有验证错误
      if (bindingResult.hasErrors()) {
          model.addAttribute("validationErrors", bindingResult.allErrors)
          return "project-form" // 返回表单页面展示错误
      }
      // 处理创建逻辑
      return "redirect:/projects"
  }
  

二、错误展示问题修复 #

1. RestController错误响应体展示 #

• 全局捕获MethodArgumentNotValidException异常，封装错误信息返回：

  @RestControllerAdvice
  class GlobalValidationHandler {
      @ExceptionHandler(MethodArgumentNotValidException::class)
      fun handleValidationErrors(ex: MethodArgumentNotValidException): ResponseEntity<Map<String, String>> {
          val errorMap = mutableMapOf<String, String>()
          ex.bindingResult.allErrors.forEach { error ->
              val fieldName = (error as FieldError).field
              val errorMsg = error.defaultMessage ?: "字段验证失败"
              errorMap[fieldName] = errorMsg
          }
          return ResponseEntity.badRequest().body(errorMap)
      }
  }
  

2. 普通Controller页面展示错误 #

• 在HTML模板中通过Model传递的错误列表遍历展示（以Thymeleaf为例）：

  <div class="alert alert-danger" th:if="${validationErrors != null}">
      <ul>
          <li th:each="error : ${validationErrors}" th:text="${error.defaultMessage}"></li>
      </ul>
  </div>
  

常见误区纠正 #

• 仅替换@Valid为@Validated无效：必须在控制器类上加@Validated，同时集合字段保留@Valid触发嵌套验证。
• Kotlin中遗漏@field:前缀：Spring无法识别属性级别的验证注解，必须指定字段级验证。

内容的提问来源于stack exchange，提问作者Oliver R.