使用 @controlleradvice 结合 @exceptionhandler 可以捕获 mongodb 驱动抛出的异常。核心做法是拦截 org.springframework.dao.dataaccessexception 或其子类(如 uncategorizedmongodbexception),在处理器方法中统一返回错误响应。

DataAccessException 能捕获哪些 MongoDB 异常
Spring Data MongoDB 会将底层驱动抛出的原生异常包装为 DataAccessException 体系下的运行时异常。因此,全局异常处理器只需针对该父类或具体子类进行匹配即可覆盖所有数据库操作异常。

import org.springframework.dao.DataAccessException;
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(DataAccessException.class)
@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
public String handleDataAccessError(DataAccessException ex) {
return "Database error: " + ex.getMessage();
}
}
上述代码定义了一个全局异常处理器。当 MongoDB 操作发生连接失败、查询语法错误或超时等异常时,Spring 会抛出 DataAccessException 的子类实例。此时 handleDataAccessError 方法会被触发,并返回 HTTP 500 状态码及错误信息。
如何区分具体的 MongoDB 异常类型
虽然父类可以捕获所有异常,但在实际业务中可能需要针对不同错误返回不同状态码。可以通过在 @ExceptionHandler 中指定更具体的子类来实现差异化处理,例如区分唯一性冲突和服务器内部错误。

import org.springframework.dao.DuplicateKeyException;
import org.springframework.dao.OptimisticLockingFailureException;
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 SpecificExceptionHandler {
@ExceptionHandler(DuplicateKeyException.class)
@ResponseStatus(HttpStatus.CONFLICT)
public String handleDuplicateKey(DuplicateKeyException ex) {
return "Conflict: Duplicate key found";
}
@ExceptionHandler(OptimisticLockingFailureException.class)
@ResponseStatus(HttpStatus.CONFLICT)
public String handleOptimisticLock(OptimisticLockingFailureException ex) {
return "Conflict: Optimistic locking failed";
}
}
通过分别声明对 DuplicateKeyException 和 OptimisticLockingFailureException 的捕获,可以实现更精细的错误控制。前者通常对应 MongoDB 的唯一索引约束违反,后者对应版本控制冲突。这些具体子类的优先级高于父类 DataAccessException,确保特定错误能被正确识别。
如何处理 MongoDB 驱动底层的 com.mongodb.MongoException
在某些极端情况下,或者使用了非 Spring 管理的原生 MongoDB 客户端时,可能会直接抛出 com.mongodb.MongoException。这类异常不属于 Spring 的 DataAccessException 体系,需要单独添加对应的 @ExceptionHandler 进行捕获,以防止应用崩溃。
import com.mongodb.MongoException;
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 MongoDriverExceptionHandler {
@ExceptionHandler(MongoException.class)
@ResponseStatus(HttpStatus.BAD_GATEWAY)
public String handleMongoDriverError(MongoException ex) {
return "Mongo driver error: " + ex.getMessage();
}
}
这段代码专门用于处理原生 MongoDB 驱动抛出的异常。当异常类型为 MongoException 时,处理器会返回 HTTP 502 状态码。这确保了即使在没有 Spring Data 封装的情况下,底层的驱动错误也能被安全地捕获并转化为标准的 HTTP 响应,避免未捕获异常导致的 500 错误页面暴露。











