AES解密报Given final block not properly padded错误，兼容外部加密串问题

核心原因 #

1. 解密未执行去填充：你的decrypt方法仅完成AES解密，没有移除加密时添加的PKCS#7填充字节。自己加密解密时可能在外部手动处理了填充，但在线工具或外部加密串的填充规则不匹配时，就会触发Given final block not properly padded错误。
2. 填充规则不兼容：不同工具默认填充方式可能不同（比如PKCS#7、Zero Padding），你的代码用PKCS#7，若在线工具或外部加密串用其他填充，必然不兼容。
3. 在线工具参数配置错误：未和你的代码保持参数一致（密钥格式、加密模式、填充方式、输入输出格式）。

修正后的代码 #

确保已安装pycryptodome库，修改解密方法添加去填充逻辑：

from Crypto.Cipher import AES
from Crypto.Util.Padding import pad, unpad

class AESCipher(object):
    def __init__(self, key):
        self.bs = AES.block_size
        self.key = bytes.fromhex(key)

    def encrypt(self, raw):
        raw = pad(raw.encode('utf-8'), AES.block_size)
        cipher = AES.new(self.key, AES.MODE_ECB)
        encrypted_data = cipher.encrypt(raw)
        return encrypted_data.hex()

    def decrypt(self, enc):
        enc = bytes.fromhex(enc)
        cipher = AES.new(self.key, AES.MODE_ECB)
        decrypted_data = cipher.decrypt(enc)
        # 移除PKCS#7填充并解码为字符串
        return unpad(decrypted_data, AES.block_size).decode('utf-8')

和在线工具兼容的步骤 #

使用在线工具时必须严格匹配以下参数：

• 加密模式：选择ECB（注意：ECB模式不安全，生产环境禁止使用）
• 密钥格式：输入Hex格式的密钥，和你传入AESCipher的key完全一致
• 填充方式：选择PKCS#7（或PKCS#5，块大小16字节时两者等价）
• 输入输出：加密时输入明文，输出选Hex；解密时输入你的加密Hex串，输出选明文

处理外部来源的加密串 #

如果外部加密串使用Zero Padding（而非PKCS#7），需改用以下解密逻辑：

def decrypt_zero_pad(self, enc):
    enc = bytes.fromhex(enc)
    cipher = AES.new(self.key, AES.MODE_ECB)
    decrypted_data = cipher.decrypt(enc)
    # 移除末尾的空字节
    return decrypted_data.rstrip(b'\x00').decode('utf-8')

重要注意事项 #

• ECB模式无安全性可言，相同明文块会生成相同密文块，生产环境请使用带IV的模式（如CBC、GCM），其中GCM还提供数据完整性验证。
• 所有交互方必须使用完全一致的加密参数，任何一项（密钥、模式、填充、编码）不匹配都会导致解密失败。

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