PyJWT生成的JWT签名无法通过OpenSSL验证的问题排查求助

我完全懂这种“明明工具自身能正常工作，但跨工具验证就失败”的头疼——咱们从几个关键细节入手排查，大概率能找到问题所在：

1. 确认算法与密钥格式完全匹配 #

首先要确保PyJWT使用的签名算法和OpenSSL命令完全一致，同时密钥格式也对应：

• 如果是HMAC算法（比如HS256）：检查PyJWT传入的密钥和OpenSSL使用的密钥是否是同一字节序列。比如PyJWT用字符串密钥时，是否是utf-8编码？OpenSSL用-hmac参数时，是否直接传入了相同的字符串？
• 如果是RSA/EC算法（比如RS256）：检查密钥格式——PyJWT默认支持PKCS#8格式（私钥开头是-----BEGIN PRIVATE KEY-----），而OpenSSL可能默认用PKCS#1格式（-----BEGIN RSA PRIVATE KEY-----）。如果格式不匹配，签名结果会完全不同。可以用OpenSSL把PKCS#1转成PKCS#8：

  openssl pkcs8 -topk8 -inform PEM -outform PEM -in rsa_private_key.pem -out pkcs8_private_key.pem -nocrypt
  

  然后让PyJWT使用转换后的密钥试试。

2. 核对待签名数据的构造细节 #

JWT的签名是基于header_base64url + "." + payload_base64url这个字符串生成的，只要这个字符串有一丝差异，签名就无法匹配：

• JSON序列化的一致性：PyJWT对header和payload做JSON序列化时，会自动对键排序（默认行为），并且不会有缩进。你手动构造待签名数据时，是否也做了同样的处理？比如手动用jq -c来序列化JSON（确保无缩进、键排序），再做Base64编码，和JWT的前两段对比。
  举个例子，用Python打印PyJWT生成的原始序列化内容：

  import jwt
  import json
  
  payload = {"user": "test"}
  header = {"alg": "HS256", "typ": "JWT"}
  # 模拟PyJWT的序列化逻辑
  serialized_header = json.dumps(header, separators=(",", ":"), sort_keys=True).encode("utf-8")
  serialized_payload = json.dumps(payload, separators=(",", ":"), sort_keys=True).encode("utf-8")
  print(serialized_header)
  print(serialized_payload)
  

  对比你手动构造的JSON字符串，看是否完全一致。
• URL-safe Base64的严格处理：PyJWT会把Base64中的+替换为-，/替换为_，并且完全去掉末尾的=填充符。你在OpenSSL实验中处理前两段时，是否严格执行了这三步？比如不要漏掉去掉=，或者替换字符时出错。

3. 签名的编码转换要正确 #

PyJWT生成的签名是URL-safe Base64编码的字符串，而OpenSSL验证时需要的是二进制签名数据（或者标准Base64编码）。在实验2中，你需要先把PyJWT的签名转换回二进制：

1. 把签名中的-换回+，_换回/；
2. 计算需要补多少个=：签名长度模4的结果，0补0个，1补3个，2补2个，3补1个；
3. 用base64 -d解码成二进制文件，再给OpenSSL验证。

比如用Bash处理：

# 假设从JWT中提取的签名是$SIGNATURE_URLSAFE
SIGNATURE_STANDARD=$(echo "$SIGNATURE_URLSAFE" | tr '-+' '_/' | awk '{printf "%s", $0; while (length($0) %4 !=0) {printf "="; $0=$0"=";}}')
echo "$SIGNATURE_STANDARD" | base64 -d > signature.bin
# 然后用OpenSSL验证：
echo -n "$HEADER_BASE64URL.$PAYLOAD_BASE64URL" > data.txt
openssl dgst -sha256 -verify pubkey.pem -signature signature.bin data.txt

4. 明确指定PyJWT的签名算法 #

不要依赖PyJWT的默认算法，在调用jwt.encode()时明确指定algorithm参数，比如：

jwt.encode(payload, private_key, algorithm="RS256")

避免因为默认算法和你预期的不一致（比如某些版本默认是HS256，但你以为用的是RS256）导致的签名不匹配。

5. 逐段对比调试 #

最直接的方法是把每一步的输出都打印出来对比：

1. 用PyJWT生成JWT后，提取header、payload、签名三段；
2. 手动构造header的JSON，序列化、URL-safe Base64编码，和JWT的第一段对比；
3. 同样处理payload，和JWT的第二段对比；
4. 如果前两段都一致，那问题肯定出在签名的生成/验证环节；如果不一致，就定位到JSON序列化或Base64编码的差异上。

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