使用 @controlleradvice 结合 @exceptionhandler 可以全局捕获编码解码异常。针对常见的乱码或格式错误,需分别处理 unsupportedencodingexception、decoderexception 和 encoderexception,并在方法中返回统一的 json 错误响应。

如何统一处理字符集转换异常
通过定义一个继承自 ResponseEntityExceptionHandler 的类,并重写 handleHttpMessageNotReadable 或直接捕获 UnsupportedEncodingException,可以拦截请求体解析时的编码问题。当 Spring MVC 尝试将请求体转换为字符串或对象时,若字符集不匹配,会抛出此异常,此时返回 400 状态码及详细错误信息。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import java.io.UnsupportedEncodingException;
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(UnsupportedEncodingException.class)
public ResponseEntity<String> handleEncodingError(UnsupportedEncodingException ex) {
return ResponseEntity.badRequest().body("编码不支持: " + ex.getMessage());
}
}
如何处理 Base64 解码失败异常
在业务逻辑中手动调用 java.util.Base64 或 javax.xml.bind.DatatypeConverter 进行解码时,若输入包含非法字符,会抛出 IllegalArgumentException 或特定的解码异常。建议在 Controller 层或 Service 层使用 try-catch 包裹,或通过 AOP 统一捕获这些运行时异常,将其转化为标准的错误响应结构,避免直接暴露堆栈信息。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import javax.xml.bind.DatatypeConverter;
import java.util.Base64;
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(IllegalArgumentException.class)
public ResponseEntity<String> handleDecodingError(IllegalArgumentException ex) {
if (ex.getMessage() != null && ex.getMessage().contains("Base64")) {
return ResponseEntity.badRequest().body("Base64 解码失败: 输入包含非法字符");
}
return ResponseEntity.internalServerError().body("未知错误: " + ex.getMessage());
}
}
当输入包含非 UTF-8 字节序列时会发生什么
如果客户端发送的请求体包含无法用 UTF-8 解码的字节序列,且服务器未配置正确的字符集过滤器,Spring Boot 默认会使用 StandardServletEncodingFilter 或容器默认编码进行解析。若字节序列无效,通常会触发 MalformedInputException 或导致 InputStream 读取中断。在全局异常处理器中,应特别关注 IOException 子类,确保这类底层 IO 异常也能被捕获并返回友好的提示,防止应用崩溃。


















