OAuth 2.0 实战：解决 ‘cannot convert access token to json’ 的常见陷阱与调试技巧

1次阅读

共计 1608 个字符，预计需要花费 5 分钟才能阅读完成。

OAuth 2.0 是一种授权框架，允许第三方应用在用户授权后访问其资源服务器上的数据，而无需共享用户凭据。其核心流程包括：

客户端向授权服务器请求授权
用户同意授权后，客户端获取授权码（Authorization Code）
客户端用授权码换取访问令牌（Access Token）
使用访问令牌访问受保护的资源

当开发者尝试解析访问令牌时，可能会遇到 cannot convert access token to json 错误。这通常表明令牌格式或处理方式存在问题：

令牌格式不符 ：授权服务器返回的可能是普通字符串而非标准 JSON
编码问题 ：响应体可能使用了非 UTF- 8 编码
响应头缺失 ：缺少 Content-Type: application/json 头部
多余字符 ：响应中可能包含 BOM 头或其他不可见字符

import requests

response = requests.post('https://auth-server.com/token', 
    data={'grant_type': 'authorization_code', 'code': 'AUTH_CODE'})
token = response.json()  # 这里可能报错

检查响应内容

print(response.text)  # 查看原始响应内容
print(response.headers)  # 检查 Content-Type

手动处理编码

# 显式指定编码
response.encoding = 'utf-8' 
raw_text = response.text

清理响应内容

# 去除 BOM 头等不可见字符
clean_text = raw_text.encode('utf-8').decode('utf-8-sig')

安全解析 JSON

import json
try:
    token = json.loads(clean_text)
except json.JSONDecodeError as e:
    print(f"JSON 解析失败: {e}")
    print(f"原始内容: {clean_text[:200]}")  # 打印前 200 字符

fetch('https://auth-server.com/token', {
  method: 'POST',
  body: new URLSearchParams({
    grant_type: 'authorization_code',
    code: 'AUTH_CODE'
  })
})
.then(response => {
  // 先检查内容类型
  const contentType = response.headers.get('content-type');
  if (!contentType.includes('application/json')) {return response.text().then(text => {throw new Error(`Expected JSON but got ${contentType}: ${text}`);
    });
  }
  return response.json();})
.catch(error => console.error('Error:', error));