PHP与Android间数据加解密异常，请求排查相关代码

架构老林

2026-5-25

排查PHP与Android跨端加解密偶发失效问题

嘿，我之前也碰到过类似的跨端加解密兼容性问题，尤其是特定短字符串加密后解不出来的情况，大概率是两端的加解密参数或者处理逻辑没对齐导致的。咱们一步步来排查：

1. 先盯紧算法模式与填充方式的一致性

这是最容易踩的坑！比如Android端用的是AES/CBC/PKCS5Padding，PHP端却只写了AES-128-CBC没明确填充方式，或者两边填充模式不匹配（虽然PKCS5和PKCS7在AES的16字节块大小下其实是兼容的，但一旦有一端没明确指定，就可能出问题）。

你要确保两端的Cipher初始化参数完全一模一样：

Android端的代码应该明确写出完整的算法字符串，比如：Cipher.getInstance("AES/CBC/PKCS5Padding");
PHP端对应的openssl解密要指定相同的模式，比如：openssl_decrypt($data, 'AES-128-CBC', $key, OPENSSL_RAW_DATA, $iv); 这里如果Android用了PKCS5Padding，PHP端默认的PKCS7Padding其实可以兼容，但最好两边都明确对齐，避免歧义。

另外，要是一端用了CBC模式（需要IV），另一端用了ECB模式（不需要IV），那短字符串加密后解密失败的概率极高——毕竟ECB是无状态的，CBC依赖IV，两者加密结果完全不同。

2. 密钥(Key)的处理必须丝毫不差

密钥是加解密的核心，一丁点差异都会导致解密失败：

两端的密钥是否是相同的字节序列？比如Android端把密钥字符串转成UTF-8字节，PHP端也要用utf8_encode($key)或者直接用字符串（PHP字符串本质是字节序列，但要确保编码一致，别Android用GBK，PHP用UTF-8）。
如果密钥是通过哈希派生的（比如用MD5/SHA256生成），两端的哈希算法和输出格式必须一致：比如Android用MessageDigest.getInstance("MD5").digest(key.getBytes("UTF-8"))，PHP端就得用md5($key, true)（第二个参数true返回原始字节，否则是十六进制字符串，这会让密钥完全不一样）。

3. 初始向量(IV)的坑一定要避开

如果用了CBC/CFB/OFB这类需要IV的模式，IV的处理必须满足三个条件：

两端用的IV完全相同；
IV长度必须等于AES的块大小（也就是16字节）；
IV要和密文一起传输！很多人犯的错是Android端随机生成IV，但没把IV传给PHP端，或者PHP端用了固定IV，这直接导致解密失败，短字符串尤其明显。

举个例子：Android可以把IV和密文拼接起来（比如前16字节是IV，后面是密文），然后PHP端拆分出IV再解密，这样就能保证两端IV一致。

4. 密文的编码与传输不能出错

Android加密后得到的是字节数组，通常会转成Base64或十六进制字符串传输，这里必须确保两端编码解码一致：

Android如果用Base64.encodeToString(cipherText, Base64.DEFAULT)，PHP端就得用base64_decode($encryptedData)；
如果Android转成十六进制，PHP端要正确用hex2bin()解码；
还要注意传输过程中的URL编码问题：比如+被转成%2B，这时候PHP端解密前要先urldecode()处理，不然密文就变了。

5. 短字符串的填充问题是重灾区

你提到的"abc"这类短字符串（小于16字节块大小），填充方式的影响会被放大：

如果Android端用了NoPadding，但PHP端默认是PKCS7填充，解密时会直接报"bad decrypt"错误；反之亦然。
自动填充模式下，短字符串会被填充到16字节，这时候PHP端必须用相同的填充方式解密，不然就会出现解密结果乱码或者失败。

6. 快速测试排查的小技巧

你可以先做个手动测试，定位问题：

用Android加密固定字符串（比如"abc"），输出加密后的Base64字符串、使用的IV（如果是CBC模式）、密钥的十六进制表示；
在PHP端用完全相同的密钥、IV、算法模式，手动解密这个Base64字符串；
如果手动解密成功，那问题大概率出在传输过程中的数据丢失/编码转换；如果手动解密失败，那肯定是两端的参数没对齐。

给你贴个经过验证的示例代码参考：

Android加密示例

import javax.crypto.Cipher;
import javax.crypto.spec.IvParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import android.util.Base64;

public class AESEncryptor {
    private static final String ALGORITHM = "AES/CBC/PKCS5Padding";
    private static final String CHARSET = "UTF-8";
    private static final int BLOCK_SIZE = 16;

    public static String encrypt(String plainText, String key, String iv) throws Exception {
        // 确保key和iv长度符合要求（AES-128的key是16字节，iv是16字节）
        SecretKeySpec secretKey = new SecretKeySpec(key.getBytes(CHARSET), "AES");
        IvParameterSpec ivSpec = new IvParameterSpec(iv.getBytes(CHARSET));
        
        Cipher cipher = Cipher.getInstance(ALGORITHM);
        cipher.init(Cipher.ENCRYPT_MODE, secretKey, ivSpec);
        
        byte[] encryptedBytes = cipher.doFinal(plainText.getBytes(CHARSET));
        return Base64.encodeToString(encryptedBytes, Base64.NO_WRAP); // 避免换行符干扰传输
    }
}

PHP解密示例

function aes_decrypt($encryptedText, $key, $iv) {
    $algorithm = 'AES-128-CBC';
    $encryptedBytes = base64_decode($encryptedText);
    // OPENSSL_RAW_DATA表示输入是原始字节，这里因为已经base64解码了，所以用这个参数
    $decrypted = openssl_decrypt(
        $encryptedBytes,
        $algorithm,
        $key,
        OPENSSL_RAW_DATA,
        $iv
    );
    return $decrypted;
}

注意：这里的key和iv必须是16字节长度（对应AES-128），如果是32字节就用AES-256，两端要一致。

7. 容易忽略的密钥长度问题

如果你的密钥长度是16字节，就得用AES-128；如果是32字节，用AES-256。要是两端不一致（比如Android用AES-256，PHP用AES-128），系统会自动填充密钥（比如用0填充），这会导致密钥实际值不一样，从而偶发解密失败——某些字符串刚好触发了这个差异的影响。

先从这些点排查，应该能找到问题所在！

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

PHP与Android间数据加解密异常，请求排查相关代码

1. 先盯紧算法模式与填充方式的一致性 #

2. 密钥(Key)的处理必须丝毫不差 #

3. 初始向量(IV)的坑一定要避开 #

4. 密文的编码与传输不能出错 #

5. 短字符串的填充问题是重灾区 #

6. 快速测试排查的小技巧 #

Android加密示例 #

PHP解密示例 #

7. 容易忽略的密钥长度问题 #