PHP与Python AES-256-CBC加密代码结果不一致问题排查

以下是你移植代码时最可能遗漏的几个核心差异点：

• 填充规则不匹配：PHP的openssl_encrypt默认使用PKCS#7填充（当明文长度不是16字节块的整数倍时，自动填充n个0x0n字节，n为需要填充的字节数）。如果Python代码中未手动实现或调用正确的PKCS7填充逻辑，直接用零填充或无填充，会导致加密结果完全不同。检查Python代码是否使用了对应填充方式，比如PyCryptodome库的Crypto.Util.Padding.pad方法。

• 字节编码差异：确认密钥、初始化向量（IV）、明文的编码完全一致。PHP中字符串默认按当前环境编码处理，若PHP代码中对密钥/明文做了编码转换（比如mb_convert_encoding转GBK），而Python直接用UTF-8编码，会导致实际参与加密的字节流不同。必须确保两端都使用相同编码（如UTF-8）将字符串转为字节后再加密。

• 输出编码处理不同：PHP的openssl_encrypt默认返回Base64编码结果；如果指定了OPENSSL_RAW_DATA选项，则返回原始加密字节，后续可能又做了Base64或URL安全Base64转换。检查Python代码的输出是否和PHP一致：若PHP用了URL安全Base64（替换+为-、/为_），Python不能直接用标准base64.b64encode，需改用base64.urlsafe_b64encode。

• IV的生成与传递逻辑：AES-CBC的IV必须是16字节长度。如果APIEncryptData中IV是动态生成的，需确认PHP和Python的生成逻辑完全一致（比如PHP用random_bytes(16)，Python用os.urandom(16)是等价的，但如果是从固定字符串截取或种子生成，必须保证两端字节完全相同）。另外，IV是否随密文一起传递或存储，两端的处理逻辑也要对齐。

• 密钥长度校验：AES-256要求密钥是32字节（256位）。PHP中如果密钥长度不足，会自动补零填充到32字节；但Python的加密库（如PyCryptodome）会直接报错。如果PHP代码中使用的密钥长度不足32字节，Python需要手动补零到相同长度，才能保证密钥一致。

示例修正（针对填充问题） #

假设Python代码未处理PKCS7填充，可补充如下逻辑：

from Crypto.Cipher import AES
from Crypto.Util.Padding import pad
import base64

def APIEncryptData(plaintext, key, iv):
    # 统一编码为UTF-8（和PHP编码一致）
    key_bytes = key.encode('utf-8')
    iv_bytes = iv.encode('utf-8')
    plaintext_bytes = plaintext.encode('utf-8')
    
    # 确保密钥是32字节（AES-256要求），不足则补零（匹配PHP行为）
    if len(key_bytes) < 32:
        key_bytes = key_bytes.ljust(32, b'\x00')
    
    # 初始化AES-CBC加密器，使用PKCS7填充
    cipher = AES.new(key_bytes, AES.MODE_CBC, iv_bytes)
    encrypted_bytes = cipher.encrypt(pad(plaintext_bytes, AES.block_size))
    
    # 转为Base64编码（匹配PHP默认输出）
    return base64.b64encode(encrypted_bytes).decode('utf-8')

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