Java PBKDF2WithHmacSHA256加解密的PHP兼容实现方法

现有Java实现核心规则 #

• 初始化向量IV：固定使用16字节全0值
• 密钥派生逻辑：以OpenSSL生成的AUTH_SECRET为输入密码、UTF-8编码的SALT为盐值，传入配置的迭代次数ITERATION_COUNT、密钥长度KEY_LENGTH，通过PBKDF2WithHmacSHA256算法派生AES密钥
• 加解密模式：采用AES/CBC/PKCS5Padding分组密码模式完成加解密
• 编码规则：密文使用Base64做编解码，明文统一使用UTF-8编码

待解决问题 #

• 不清楚AUTH_SECRET参数应该在PHP实现的哪个环节传入
• 自行编写的初步PHP代码（包含derivate_key密钥派生函数、encrypt加密函数，加密时额外计算HMAC值并拼接IV、HMAC、原始密文后做Base64编码）输出结果与Java实现完全不一致，无法实现跨语言加解密互通

AUTH_SECRET传参位置 #

AUTH_SECRET是PBKDF2密钥派生的输入密码参数，直接作为hash_pbkdf2函数的第二个入参传入即可，不需要做额外编码或哈希处理。

PHPhash_pbkdf2和JavaPBKDF2WithHmacSHA256的参数严格对应关系如下：

• 算法参数固定传sha256，对应Java侧的HmacSHA256摘要算法
• 密码参数直接传入AUTH_SECRET原始字符串
• 盐参数传入UTF-8编码后的SALT字符串，不要额外做Base64、十六进制转码
• 迭代次数参数传入和Java侧完全一致的ITERATION_COUNT数值
• 密钥长度参数传入字节单位的长度值：如果Java侧KEY_LENGTH按位配置（如256位AES传256），PHP侧需要除以8转成字节长度（256位对应32字节），这是最常见的不兼容诱因
• 最后一个raw_output参数固定传true，返回原始二进制格式密钥，不要用默认的十六进制字符串输出

密文不匹配问题修复 #

之前的代码输出和Java不一致，核心原因是额外增加了Java侧不存在的逻辑：

1. 按照给出的Java实现规则，IV是固定16字节全0值，不需要拼接到密文中传输
2. Java实现没有额外计算HMAC值的逻辑，自行添加的HMAC计算、IV+HMAC+密文拼接步骤完全是多余的，会直接改变最终密文结构
3. PHP OpenSSL扩展默认的PKCS7填充在AES 16字节分组场景下，和Java的PKCS5Padding逻辑完全兼容，不需要自行实现填充逻辑

完整兼容PHP实现代码 #

<?php
// 以下配置参数必须和Java端完全一致
define('AUTH_SECRET', '替换为你的OpenSSL生成密钥');
define('SALT', '替换为你的盐值');
define('ITERATION_COUNT', 10000); // 替换为实际迭代次数
define('KEY_LENGTH_BYTE', 32); // 256位AES对应32字节，128位AES对应16字节
define('IV', str_repeat("\x00", 16)); // 固定16字节全0IV，和Java逻辑对齐

/**
 * 派生AES密钥（二进制格式）
 */
function derivateKey() {
    $salt = mb_convert_encoding(SALT, 'UTF-8');
    return hash_pbkdf2(
        'sha256',
        AUTH_SECRET,
        $salt,
        ITERATION_COUNT,
        KEY_LENGTH_BYTE,
        true
    );
}

/**
 * 加密
 * @param string $plaintext 明文
 * @return string Base64编码密文
 */
function encrypt($plaintext) {
    $key = derivateKey();
    $plaintext = mb_convert_encoding($plaintext, 'UTF-8');
    $cipherRaw = openssl_encrypt(
        $plaintext,
        'AES-' . (KEY_LENGTH_BYTE * 8) . '-CBC',
        $key,
        OPENSSL_RAW_DATA,
        IV
    );
    return base64_encode($cipherRaw);
}

/**
 * 解密
 * @param string $ciphertextBase64 Base64编码密文
 * @return string UTF-8格式明文
 */
function decrypt($ciphertextBase64) {
    $key = derivateKey();
    $cipherRaw = base64_decode($ciphertextBase64);
    $plaintext = openssl_decrypt(
        $cipherRaw,
        'AES-' . (KEY_LENGTH_BYTE * 8) . '-CBC',
        $key,
        OPENSSL_RAW_DATA,
        IV
    );
    return mb_convert_encoding($plaintext, 'UTF-8');
}

验证注意事项 #

• 所有加密中间值（密钥、IV、原始密文）全程保持原始二进制格式，仅在最终输出密文时做Base64编码
• 不要随意添加HMAC校验、自定义填充逻辑，除非Java侧有完全一致的实现规则
• 迭代次数、密钥长度、盐值、IV任意一个参数不一致，都会导致加解密结果完全不同

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