Java AES 128 ECB升级为AES 256 ECB遇坏填充异常求助

AES 256 ECB模式本身无适配障碍，运行时抛坏填充异常90%以上来自固定配置不匹配，和模式本身无关：

• JDK默认密钥长度权限限制，老版本JDK默认仅支持AES128
• 密钥长度未对齐：AES256要求密钥必须为32字节，非加密端约定的密钥长度直接导致解密乱码、触发填充校验失败
• 填充模式、编码格式未和加密端对齐
• 直接复用原AES128的16字节密钥适配256模式，没有按加密端约定生成32字节密钥

import javax.crypto.Cipher;
import javax.crypto.spec.SecretKeySpec;
import java.nio.charset.StandardCharsets;
import java.util.Base64;

public class Aes256EcbDecryptUtil {
    /**
     * AES256 ECB解密
     * @param cipherText Base64编码的待解密密文
     * @param secretKey 和加密端完全一致的32字节密钥
     * @return 解密后明文
     * @throws Exception 透传解密异常，便于定位问题
     */
    public static String decrypt(String cipherText, String secretKey) throws Exception {
        // 前置校验密钥长度，避免长度不匹配导致的无意义解密
        byte[] keyBytes = secretKey.getBytes(StandardCharsets.UTF_8);
        if (keyBytes.length != 32) {
            throw new IllegalArgumentException(String.format("AES256要求密钥长度为32字节，当前传入密钥长度为%d字节，请对齐加密端配置", keyBytes.length));
        }

        // 模式+填充必须和加密端完全一致，禁止仅写"ECB"依赖默认值
        // 常见对齐项：AES/ECB/PKCS5Padding、AES/ECB/PKCS7Padding、AES/ECB/NoPadding
        Cipher cipher = Cipher.getInstance("AES/ECB/PKCS5Padding");
        SecretKeySpec keySpec = new SecretKeySpec(keyBytes, "AES");
        cipher.init(Cipher.DECRYPT_MODE, keySpec);

        // 密文解码格式必须和加密端一致（Base64/Hex）
        byte[] plainBytes = cipher.doFinal(Base64.getDecoder().decode(cipherText));
        return new String(plainBytes, StandardCharsets.UTF_8);
    }
}

按优先级逐点校验，定位效率最高：

• 校验JDK权限支持度：运行代码打印Cipher.getMaxAllowedKeyLength("AES")，若返回128说明当前JDK未放开AES256权限。JDK8u161之前版本需替换JCE无限制权限策略文件到jre/lib/security目录，JDK8u161+、JDK9+默认放开256权限，无需额外配置
• 对齐密钥配置：和加密端确认32字节密钥的生成规则（是否做了固定偏移、是否补位、编码格式），禁止直接复用原AES128场景的16字节密钥
• 对齐填充与编码：把Cipher初始化的填充类型、密文解码格式、明文编码格式和加密端完全对齐。Java的PKCS5Padding与其他语言（Python/Go/C#）的PKCS7Padding完全兼容，无跨语言适配问题
• 跨语言对接注意点：如果加密端未做填充（NoPadding），解密端必须同步设置为NoPadding，否则即使密钥正确也会触发坏填充校验

内容的提问来源于stack exchange，提问作者TweaknFreak