openssl_encrypt加密失败主因是参数不匹配:$data非string、密钥长度不符(aes-256需32字节)、iv未用openssl_random_pseudo_bytes生成或长度错误、误用openssl_zero_padding、算法选错(禁用ecb/旧mcrypt写法)、解密时iv/选项/base64处理不一致、密钥硬编码或弱派生。

openssl_encrypt 加密失败:返回 false 或空字符串
绝大多数情况是参数不匹配,openssl_encrypt 对输入、密钥、IV、算法都极其敏感,任一环节错位就静默失败。
- 检查
$data是否为 string 类型——传 array 或 null 会直接返回false,可用is_string($data)预判 - 密钥长度必须严格匹配算法要求:AES-128 要 16 字节,AES-192 要 24 字节,AES-256 要 32 字节;用
mb_strlen($key, '8bit')算真实字节数,别信strlen()(对 UTF-8 多字节字符会出错) - IV 必须用
openssl_random_pseudo_bytes()生成,且长度等于对应算法的块大小(如 AES 是 16 字节);硬编码或短 IV 会导致加密失败或报error:06065064:digital envelope routines:EVP_CipherFinal_ex:bad decrypt - 如果用
OPENSSL_ZERO_PADDING,必须自己手动补零且长度对齐块大小,否则解密端根本无法还原——绝大多数场景不该用它
选什么算法和模式?不要碰 mcrypt 遗留写法
PHP 7.2+ 已移除 mcrypt,但很多人抄旧代码还在用 MCRYPT_RIJNDAEL_128 这类写法,这和 openssl 的 AES 不等价,不能混用。
- 只用
'AES-256-CBC'或'AES-256-GCM':前者兼容性好,后者支持认证加密(防篡改),但 PHP 7.1+ 才完整支持 GCM 的 AEAD 模式 - CBC 模式必须配 IV,且每次加密都要用新 IV(和密文一起存/传);GCM 模式除了 IV(叫 nonce),还需
$tag变量接收认证标签,漏掉&$tag引用会导致加密成功但解密失败 - 避免
'AES-128-ECB':ECB 不用 IV,但相同明文块永远输出相同密文块,极易被模式分析——登录态、金额类数据绝不能用
解密时 openssl_decrypt 报 “bad decrypt” 错误
这不是密钥错了,大概率是 IV、填充方式、或密文被截断/编码损坏。
- 确保解密用的 IV 和加密时完全一致——常见错误是加密后 base64_encode 了密文和 IV,但解密前只对密文做了 base64_decode,忘了处理 IV
- 确认加密和解密用的
$options一致:比如加密用了OPENSSL_RAW_DATA,解密也得用它;若加密用了OPENSSL_ZERO_PADDING,解密也得带上,否则填充逻辑对不上 - 密文如果是从 URL 或表单过来的,注意
+号被当空格、/被转义、末尾=被截断——base64 解码前先做str_replace(['-', '_'], ['+', '/'], $encoded)并补足=(用str_pad($s, ceil(strlen($s) / 4) * 4, '='))
密钥怎么安全存?别硬编码在代码里
加密没意义,如果密钥随手写在 config.php 里,或者藏在注释里,攻击者拿到文件就全完了。
- 生产环境密钥应由系统级机制注入:Linux 下用环境变量(
$_SERVER['ENCRYPTION_KEY']),Docker 用secrets,K8s 用Secret挂载文件 - 绝对不用
md5('my_password')当密钥——哈希不是密钥派生,缺乏 salt 和迭代,容易被彩虹表击穿;真要从口令派生,用hash_pbkdf2('sha256', $password, $salt, $iterations, 32, true),且 salt 必须随机、唯一、和密文一起存 - 密钥轮换时,老数据需用旧密钥解密 + 新密钥重加密;别幻想“一把密钥管十年”,尤其涉及用户身份证、银行卡等字段
密钥管理、IV 生成、base64 编解码边界、以及 CBC/GCM 模式下 tag 和 nonce 的生命周期——这些地方不出错,加密才真正起作用。写完记得跑一遍加密→存储→读取→解密全流程,中间任何一步做字符串拼接或类型转换,都可能让密文无声失效。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











