spring boot 全局异常处理捕获签名验证异常的核心做法是:在自定义的签名校验逻辑中主动抛出特定的业务异常(如 sigverificationexception),并在配置类中注册一个使用 @exceptionhandler 注解的方法专门拦截该异常。这样,当请求进入控制器之前或之中发生签名错误时,spring mvc 会自动将控制权交给这个处理器方法,返回统一的 json 格式错误响应,而不会触发默认的 500 错误页面。

如何定义并抛出签名验证异常
要实现捕获,第一步是创建一个继承自 RuntimeException 的自定义异常类,用于标识签名无效。在过滤器或拦截器中检测到签名不匹配时,直接 throw 这个异常即可。例如,定义 SigVerificationException 并在 SigFilter 中调用 throw new SigVerificationException("Invalid Signature"),这会将错误信息传递给 Spring 的异常处理机制。

package com.example.exception;
public class SigVerificationException extends RuntimeException {
public SigVerificationException(String message) {
super(message);
}
}
package com.example.filter;
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
public class SigFilter implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
HttpServletRequest req = (HttpServletRequest) request;
String sig = req.getHeader("X-Signature");
// 假设验证逻辑失败
if (!"valid_sig".equals(sig)) {
throw new SigVerificationException("Signature mismatch");
}
chain.doFilter(request, response);
}
}
上述代码展示了过滤器的基本结构。当 sig 不等于预期值时,程序立即抛出 SigVerificationException。由于过滤器运行在 DispatcherServlet 之前,这个异常会被 Spring 的底层异常解析器捕获,并寻找合适的 @ExceptionHandler 进行处理。
如何配置全局异常处理器
第二步是编写一个 @RestControllerAdvice 类,在其中添加一个方法,参数类型为刚才定义的 SigVerificationException。该方法返回一个自定义的响应体对象,通常包含状态码和错误消息。Spring Boot 会自动将该方法的返回值序列化为 JSON 并写入 HTTP 响应。

package com.example.config;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(SigVerificationException.class)
public ResponseEntity<ErrorResponse> handleSigException(SigVerificationException ex) {
ErrorResponse error = new ErrorResponse(401, ex.getMessage());
return ResponseEntity.status(401).body(error);
}
}
// 辅助类
class ErrorResponse {
private int code;
private String message;
public ErrorResponse(int code, String message) {
this.code = code;
this.message = message;
}
// getters and setters omitted for brevity
}
在这个配置类中,@ExceptionHandler 明确指定了只处理 SigVerificationException。当过滤器抛出该异常时,Spring 会执行 handleSigException 方法,构建一个包含 401 状态码和具体错误信息的 ErrorResponse 对象。最终客户端收到的是标准的 JSON 响应,便于前端进行统一错误处理。
签名验证失败时的具体返回结果是什么
当签名验证失败时,系统会返回 HTTP 状态码 401 Unauthorized,响应体为 JSON 格式,包含 code 字段为 401,message 字段为 "Signature mismatch"。这是由 GlobalExceptionHandler 中 handleSigException 方法决定的。如果未配置此处理器,默认行为可能是 500 Internal Server Error 或空白页,因此显式定义处理器至关重要。


















