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 里，或者藏在注释里，攻击者拿到文件就全完了。
立即学习“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 的生命周期——这些地方不出错，加密才真正起作用。写完记得跑一遍加密→存储→读取→解密全流程，中间任何一步做字符串拼接或类型转换，都可能让密文无声失效。
