spring boot 全局异常处理可以通过实现 handlerexceptionresolver 接口或添加带有 @controlleradvice 的类来捕获 mybatis 映射异常。具体做法是定义一个全局异常处理器,在方法中检查异常类型是否为 org.apache.ibatis.binding.bindingexception 或其子类,如果是则返回自定义的错误响应。这样做可以统一处理因 sql 映射配置错误、参数绑定失败等导致的异常,避免程序崩溃并返回友好的错误信息。

如何配置全局异常处理器以捕获 BindingException
要捕获 MyBatis 的 BindingException,需要在 Spring Boot 应用中创建一个全局异常处理类。该类应使用 @RestControllerAdvice 注解,并在其中定义一个处理方法,该方法接收 BindingException 作为参数。当 MyBatis 抛出此类异常时,Spring MVC 会自动将其传递给该处理方法。在此方法中,可以记录日志并返回一个包含错误信息的 JSON 对象。例如,可以返回状态码 400 和具体的错误消息,如 "SQL 映射配置错误"。

import org.apache.ibatis.binding.BindingException;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BindingException.class)
@ResponseStatus(HttpStatus.BAD_REQUEST)
public String handleBindingException(BindingException ex) {
return "MyBatis Binding Error: " + ex.getMessage();
}
}
上述代码定义了一个简单的全局异常处理器。当 BindingException 被抛出时,handleBindingException 方法会被调用,并返回一个字符串形式的错误消息。在实际应用中,建议返回更结构化的 JSON 响应,以便前端更好地解析和处理错误。
如何处理其他常见的 MyBatis 异常
除了 BindingException,MyBatis 还可能抛出其他类型的异常,如 PersistenceException 或 SQLException。为了全面处理这些异常,可以在全局异常处理器中添加更多的 @ExceptionHandler 方法。每个方法针对特定的异常类型,并返回相应的错误响应。例如,对于 PersistenceException,可以返回一个通用的数据库操作错误消息;对于 SQLException,可以返回更详细的 SQL 错误信息。

import org.apache.ibatis.exceptions.PersistenceException;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BindingException.class)
@ResponseStatus(HttpStatus.BAD_REQUEST)
public String handleBindingException(BindingException ex) {
return "MyBatis Binding Error: " + ex.getMessage();
}
@ExceptionHandler(PersistenceException.class)
@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
public String handlePersistenceException(PersistenceException ex) {
return "Database Operation Error: " + ex.getMessage();
}
@ExceptionHandler(SQLException.class)
@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
public String handleSQLException(SQLException ex) {
return "SQL Error: " + ex.getMessage();
}
}
通过这种方式,可以确保不同类型的 MyBatis 异常都能得到适当的处理。每个异常处理方法都可以根据具体情况定制错误响应,从而提高应用的健壮性和用户体验。
当 MyBatis 映射文件中的参数名与实体类属性不匹配时会发生什么
当 MyBatis 映射文件中的参数名与实体类属性不匹配时,MyBatis 会抛出 BindingException。这是因为 MyBatis 在尝试将请求参数绑定到实体类属性时,无法找到对应的属性,从而导致绑定失败。例如,如果映射文件中使用了 #{userName},但实体类中只有 username 属性,MyBatis 将无法正确绑定参数,进而抛出异常。在这种情况下,全局异常处理器会捕获该异常,并返回相应的错误消息,提示用户检查映射文件和实体类的定义。


















