Java中 JWT 签名验签失败 Invalid Signature 怎么抛出 JwtSignatureException-java教程-PHP中文网

jwtsignatureexception是spring security在jwt签名验证失败时抛出的标准异常，由jwtdecoder自动触发或手动封装，需确保密钥一致、算法匹配，并避免日志泄露token明文。

java中 jwt 签名验签失败 invalid signature 怎么抛出 jwtsignatureexception

<p>JWT 签名验签失败时抛出 <code>JwtSignatureException</code>，核心在于捕获底层签名验证异常并主动封装为 Spring Security 提供的标准异常类型。</p>

<h3>使用 JwtDecoder 时自动抛出 JwtSignatureException</h3>
<p>Spring Security 5.7+ 的 <code>JwtDecoder</code>（如 <code>NimbusJwtDecoder</code>）在签名验证失败时，默认就会抛出 <code>JwtSignatureException</code>，无需手动 throw。只要配置正确，框架会自动处理：</p>

确保使用的是 NimbusJwtDecoder 或支持签名验证的实现
密钥（SecretKey 或 RSAKey）必须与签发时一致，且未被篡改
JWT header 中的 alg 值（如 HS256、RS256）需与解码器预期匹配

手动验证 JWT 并显式抛出 JwtSignatureException

若需自定义校验逻辑（例如预处理 token、多密钥路由），可调用 JwtDecoder#decode 并捕获异常后重新抛出：

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

<code>try {
    Jwt jwt = jwtDecoder.decode(token);
} catch (JwtValidationException ex) {
    // Nimbus 抛 JwtValidationException，含签名失败原因
    throw new JwtSignatureException("Invalid signature", token, ex);
} catch (RuntimeException ex) {
    // 其他运行时异常（如解析失败、过期等）不一定是签名问题
    if (ex instanceof JwtSignatureException) {
        throw ex;
    }
    throw new JwtSignatureException("Signature verification failed", token, ex);
}</code>

自定义 JwtDecoder 包装异常

若想统一拦截所有签名失败场景，可包装原始 decoder：

继承 AbstractJwtDecoder 或装饰 JwtDecoder
重写 decode 方法，在 catch JwtValidationException 时判断是否由签名引起（检查 cause 是否为 SignatureException 或消息含 "signature"）
仅对签名类错误构造 JwtSignatureException，其他保留原异常