phpseclib 3 默认使用 SHA256 进行 OAEP 加密/解密，而 phpseclib 2 默认使用 SHA1；若用 v2 加密的数据需在 v3 中解密，必须显式指定 withHash("sha1") 和 withMGFHash("sha1")，否则会解密失败。
phpseclib 3 默认使用 sha256 进行 oaep 加密/解密，而 phpseclib 2 默认使用 sha1；若用 v2 加密的数据需在 v3 中解密，必须显式指定 `withhash("sha1")` 和 `withmgfhash("sha1")`，否则会解密失败。
在从 phpseclib 2 升级到 phpseclib 3 的过程中，RSA 解密突然失败是一个典型兼容性问题。根本原因在于：两者虽均默认采用 OAEP 填充方案，但底层哈希算法不一致：
- phpseclib 2：OAEP 的主哈希（hash）与掩码生成函数哈希（MGF1 hash）默认均为
SHA1； - phpseclib 3：二者默认均升级为更安全的
SHA256。
这意味着：
✅ 使用 phpseclib 2 加密的密文（如通过 $rsa->encrypt($data)），其内部使用的是 SHA1 + SHA1 的 OAEP 参数；
❌ 若直接用 phpseclib 3 的 $private->decrypt() 尝试解密，因默认期望 SHA256 + SHA256，参数不匹配将导致解密失败（通常抛出 Invalid ciphertext 或静默返回 false）。
✅ 正确的 phpseclib 3 兼容写法
use phpseclib3\Crypt\PublicKeyLoader;
$private = PublicKeyLoader::load($PRIVATE_KEY);
// 显式指定与 v2 一致的哈希算法
$decrypted = $private
->withHash('sha1')
->withMGFHash('sha1')
->decrypt(base64_decode($a));
if ($decrypted === false) {
throw new RuntimeException('RSA decryption failed: invalid padding or key mismatch');
}
? 提示：
withHash()设置 OAEP 主哈希，withMGFHash()设置 MGF1 子哈希，二者必须同时设为'sha1'才能完全复现 v2 行为。
⚠️ 安全性说明与迁移建议
尽管 SHA1 在签名和证书场景中已被广泛弃用，但在 OAEP 模式下，目前尚无已知实际攻击可利用 SHA1 的碰撞弱点实现解密绕过（参见 Security StackExchange 分析）。因此，短期兼容性适配使用 sha1 是可行的。
但长期来看，强烈建议主动升级加密流程：
- 新系统一律采用
SHA256（v3 默认值，无需额外配置）； - 对存量数据，可在服务端加一层兼容逻辑（如根据密文前缀或元数据判断版本），或批量重新加密；
- 避免在新项目中硬编码
sha1，可通过配置驱动哈希策略，便于未来平滑切换。
✅ 验证是否真正兼容的小技巧
若你拥有原始明文和 v2 加密后的密文，可用以下方式交叉验证：
// 在 v3 中用 sha1 参数解密后，与原始明文比对
$original = 'Hello World';
$encrypted_v2 = base64_encode($rsa_v2->encrypt($original)); // v2 加密结果
$decrypted_v3 = $private_v3->withHash('sha1')->withMGFHash('sha1')->decrypt(base64_decode($encrypted_v2));
assert($decrypted_v3 === $original); // 应通过
总之，phpseclib 3 的设计更现代、更安全，解密失败并非 Bug，而是加密参数显式化带来的必要提醒——把握 withHash() 和 withMGFHash() 这两个关键配置点，即可无缝承接历史数据，同时为全面迁移到 SHA256 奠定基础。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
