Java中加解密失败 CryptoException 自定义异常怎么编写-java教程-PHP中文网

java中需自定义cryptoexception而非直接使用jdk异常，因其语义更明确、便于统一处理；推荐继承runtimeexception并增强错误码与上下文字段，用于精准标识密码学错误、支持分类日志与标准化响应。

java中加解密失败 cryptoexception 自定义异常怎么编写

Java中加解密失败时抛出的 CryptoException 通常不是JDK自带的异常，而是需要开发者根据业务场景自定义的运行时异常，用于清晰区分密码学操作失败（如密钥不匹配、算法不支持、数据损坏等），避免与通用异常混用。

为什么需要自定义 CryptoException

标准异常如 GeneralSecurityException 或 IllegalBlockSizeException 层级太宽、语义不够明确；直接抛原始异常不利于上层统一捕获和处理。自定义 CryptoException 可以： • 明确标识这是密码学相关错误 • 携带更具体的上下文（如算法名、操作类型、失败阶段） • 支持分类日志、监控告警或用户友好提示

基础写法：继承 RuntimeException

推荐继承 RuntimeException，避免强制上层 try-catch，符合加解密通常是程序内部关键路径、失败即需中断的语义：

Java JDK 25

Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。

下载

public class CryptoException extends RuntimeException {
    public CryptoException(String message) {
        super(message);
    }

    public CryptoException(String message, Throwable cause) {
        super(message, cause);
    }
}

增强版：添加错误码和上下文字段

实际项目中建议加入可扩展字段，便于诊断和国际化：

public class CryptoException extends RuntimeException {
    private final String errorCode;
    private final String algorithm;
    private final String operation; // "encrypt" / "decrypt"

    public CryptoException(String message, String errorCode, String algorithm, String operation) {
        this(message, errorCode, algorithm, operation, null);
    }

    public CryptoException(String message, String errorCode, String algorithm, String operation, Throwable cause) {
        super(message, cause);
        this.errorCode = errorCode;
        this.algorithm = algorithm;
        this.operation = operation;
    }

    // getter 方法略（可根据需要生成）
}

使用示例：

if (key == null) {
    throw new CryptoException("密钥为空", "CRYPTO_KEY_NULL", "AES/GCM/NoPadding", "encrypt");
}

配合使用建议

• 在工具类（如 AesUtil）中集中抛出该异常，不要混用 IllegalArgumentException 或裸 RuntimeException • 日志中打印 errorCode 和 algorithm，方便排查是算法配置问题还是数据问题 • Web接口可全局捕获 CryptoException，返回标准化错误响应（如 400 Bad Request + 错误码） • 单元测试中显式验证特定场景是否抛出对应 CryptoException，增强健壮性