Django REST Framework中JWT RS256算法签名解码错误排查

先看你提供的Token示例：b'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJpc191c2VyIjp0cnVlfQ.'，结合RS256算法的配置，我们可以从这几个核心点排查问题：

1. 返回的Token带字节串标识b''，导致签名解析失败 #

Python里jwt.encode()默认返回字节对象（bytes），如果直接把这个对象返回给前端，会被序列化成带b'前缀和'后缀的字符串。当你把这个带标识的字符串传给服务器验证时，JWT库会把b'当成Token的一部分，自然无法正确解码签名。

解决方法：
在登录视图生成Token后，必须解码为UTF-8字符串再返回：

# 以PyJWT库为例
import jwt
from django.conf import settings

payload = {'user_id': user.id, 'is_user': True}
# 用私钥签名，明确指定RS256算法
token_bytes = jwt.encode(payload, settings.JWT_PRIVATE_KEY, algorithm='RS256')
# 解码为字符串后返回给前端
token = token_bytes.decode('utf-8')
return Response({'username': user.username, 'email': user.email, 'token': token})

如果用的是djangorestframework-simplejwt，确保用库提供的序列化器（比如TokenObtainPairSerializer）生成Token，它会自动处理字符串转换。

2. Token实际签名算法与配置的RS256不匹配 #

你的Token头部解码后是{"typ":"JWT","alg":"HS256"}——这说明Token是用HS256（对称加密）签名的，但你配置的是RS256（非对称加密）。服务器用RS256去验证HS256签名的Token，必然会报"Error decoding signature."。

解决原因：

• 生成Token时没明确指定algorithm='RS256'，导致JWT库用了默认的HS256；
• 或者settings.py中的算法配置未生效。以simplejwt为例，正确配置如下：

# settings.py
from datetime import timedelta

REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': (
        'rest_framework_simplejwt.authentication.JWTAuthentication',
    ),
}

SIMPLE_JWT = {
    'ALGORITHM': 'RS256',
    'RS256_PRIVATE_KEY': open('path/to/your/private.pem').read(),
    'RS256_PUBLIC_KEY': open('path/to/your/public.pem').read(),
    'ACCESS_TOKEN_LIFETIME': timedelta(minutes=5),
    # 其他按需配置
}

如果用原生PyJWT，每次调用jwt.encode()都要指定algorithm='RS256'，验证时用公钥：

# 验证Token示例
try:
    payload = jwt.decode(token, settings.JWT_PUBLIC_KEY, algorithms=['RS256'])
except jwt.InvalidSignatureError:
    # 处理签名无效逻辑

3. 非对称密钥对不匹配或格式错误 #

RS256需要一对匹配的私钥（签名用）和公钥（验证用）。如果密钥不是成对生成的，或者读取时格式错误（比如PEM文件内容被截断、包含多余字符），也会导致验证失败。

解决方法：
用OpenSSL重新生成标准密钥对：

# 生成私钥
openssl genrsa -out private.pem 2048
# 从私钥导出公钥
openssl rsa -in private.pem -pubout -out public.pem

然后在settings.py中确保正确读取密钥文件，检查文件路径和权限是否正常。

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