使用pyca/cryptography分块加解密大文件时PKCS7 Padding的正确用法

你的加密和解密收尾逻辑完全符合PKCS7填充/去填充与AES-CBC加密的规范要求，以下是具体分析和关键注意事项：

核心逻辑正确性说明 #

加密收尾流程 #

fout.write(encryptor.update(padder.finalize())) + fout.write(encryptor.finalize()) 是正确的：

• PKCS7填充的核心是对明文的最后一块补充字节，使总长度对齐AES块大小（16字节）。padder.finalize()会生成这部分填充字节，必须通过加密器处理后再写入文件——直接写入填充字节会导致明文填充信息暴露，这正是你之前踩的坑，现在的处理方式完全规避了这个问题。
• encryptor.update(padder.finalize()) 处理填充字节的加密，encryptor.finalize() 确保加密器完成所有残留数据的处理，符合pyca/cryptography的加密器生命周期要求。

解密收尾流程 #

fout.write(unpadder.update(decryptor.finalize())) + fout.write(unpadder.finalize()) 同样正确：

• AES-CBC解密后，最后一块数据会包含PKCS7填充字节，必须先完成所有密文的解密，再对完整的明文数据做去填充。
• decryptor.finalize() 输出最后一块解密后的明文（包含填充字节），unpadder.update() 处理这部分数据，最后unpadder.finalize() 移除填充字节，得到原始明文。

超大文件分块处理的关键注意事项 #

1. IV的存储与读取
   AES-CBC模式必须使用随机生成的16字节IV，加密时要将IV写入文件头部（比如第一个16字节），解密时先读取IV再初始化解密器，否则无法正确解密。
2. 分块大小的对齐
   分块大小建议设置为AES块大小（16字节）的整数倍，你选择的2GB分块是合规的（2GB = 2147483648字节，是16的整数倍），避免读取非对齐块导致解密器报错。
3. 分块处理的完整流程
   前面的分块数据要先通过padder.update()（加密）或decryptor.update()（解密）逐步处理，仅在最后一块数据处理完成后再调用padder.finalize()或decryptor.finalize()，确保填充/解密流程的连续性。

简化的合规代码示例 #

加密代码 #

from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes
from cryptography.hazmat.primitives import padding
from cryptography.hazmat.backends import default_backend
import os

def encrypt_large_file(input_path, output_path, key, chunk_size=2*1024*1024*1024):
    iv = os.urandom(16)
    backend = default_backend()
    cipher = Cipher(algorithms.AES(key), modes.CBC(iv), backend=backend)
    encryptor = cipher.encryptor()
    padder = padding.PKCS7(128).padder()

    with open(input_path, 'rb') as fin, open(output_path, 'wb') as fout:
        fout.write(iv)
        while True:
            chunk = fin.read(chunk_size)
            if not chunk:
                break
            fout.write(encryptor.update(padder.update(chunk)))
        
        # 处理填充与加密收尾
        final_padded = padder.finalize()
        fout.write(encryptor.update(final_padded))
        fout.write(encryptor.finalize())

解密代码 #

def decrypt_large_file(input_path, output_path, key, chunk_size=2*1024*1024*1024):
    backend = default_backend()
    with open(input_path, 'rb') as fin, open(output_path, 'wb') as fout:
        iv = fin.read(16)
        cipher = Cipher(algorithms.AES(key), modes.CBC(iv), backend=backend)
        decryptor = cipher.decryptor()
        unpadder = padding.PKCS7(128).unpadder()

        while True:
            chunk = fin.read(chunk_size)
            if not chunk:
                break
            fout.write(unpadder.update(decryptor.update(chunk)))
        
        # 处理解密与去填充收尾
        final_decrypted = decryptor.finalize()
        fout.write(unpadder.update(final_decrypted))
        fout.write(unpadder.finalize())

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