PHP RSA签名变量验证失败问题求助

这种情况我太熟了！分开写签名和验证函数就验证失败，但放一起就正常，大概率是密钥、数据或者签名传输过程中藏着细节坑——哪怕你看着签名内容一样，实际可能已经悄悄变了。下面是几个最常见的排查方向：

1. 密钥加载一致性问题 #

你可能以为签名用的私钥和验证用的公钥是配对的，但实际加载过程中出了错：

• 比如签名函数里直接加载了完整的PEM私钥，而验证函数里的公钥是从私钥导出后又被意外修改（比如多了换行、空格，或者格式错误）。
• 调试技巧：在两个函数里分别打印公钥的哈希值，确认是同一个：

  // 签名函数里导出公钥并哈希
  $publicKey = $rsa->getPublicKey();
  echo hash('sha256', $publicKey);
  
  // 验证函数里加载公钥后哈希
  $loadedPublicKey = $rsa->loadKey($publicKeyString);
  echo hash('sha256', $loadedPublicKey);
  

  如果哈希值不一样，说明公钥加载有误，检查公钥的存储/传输过程是否被篡改。

2. 签名的编码/传输问题 #

RSA签名生成的是二进制数据，如果直接存储或传输，很容易因为编码问题被破坏（比如API传输时默认用UTF-8解析，二进制里的不可见字符会被转义）：

• 正确的做法是：签名后把二进制转成Base64编码，验证时再解码回二进制。示例代码：

  // 签名函数
  function generateRsaSignature($data, $privateKey) {
      $rsa = new RSA();
      $rsa->loadKey($privateKey);
      $rsa->setHash('sha256');
      $rsa->setSignatureMode(RSA::SIGNATURE_PKCS1);
      
      $signature = $rsa->sign($data);
      // 转Base64方便传输存储
      return base64_encode($signature);
  }
  
  // 验证函数
  function verifyRsaSignature($data, $signature, $publicKey) {
      $rsa = new RSA();
      $rsa->loadKey($publicKey);
      $rsa->setHash('sha256');
      $rsa->setSignatureMode(RSA::SIGNATURE_PKCS1);
      
      // 先解码Base64
      $decodedSignature = base64_decode($signature);
      return $rsa->verify($data, $decodedSignature);
  }
  

3. 待签名数据的一致性问题 #

你以为签名和验证的是同一个数据，但实际数据已经被悄悄修改：

• 比如签名时用json_encode($payload)，但验证时从API请求获取的JSON字符串，因为编码参数不同（比如是否转义斜杠、是否格式化）导致字符串不一致。
• 解决办法：对数据做标准化处理，固定编码参数，确保签名和验证用的是完全相同的字符串：

  // 签名和验证前都用这个标准化数据
  $standardizedData = json_encode($data, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
  

  也可以对比两个函数里$data的哈希值，确认是否一致。

4. PHPSECLIB实例配置不一致 #

两个函数里的RSA实例可能用了不同的哈希算法或签名模式：

• phpseclib 2.0中，默认的签名哈希算法可能不是你预期的（比如SHA1），必须显式指定相同的配置。
• 确保签名和验证函数里的RSA实例都设置了相同的哈希算法和签名模式，就像上面代码示例里的setHash('sha256')和setSignatureMode(RSA::SIGNATURE_PKCS1)。

最后调试技巧 #

如果还是找不到问题，把以下几个值的哈希值打印出来对比：

• 签名函数里的$standardizedData的哈希
• 验证函数里的$standardizedData的哈希
• 签名函数里base64_encode($signature)的哈希
• 验证函数里传入的$signature的哈希

哪一组哈希不一样，问题就出在哪一步。

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