FastAPI中OAuth2 Password Bearer获取token显示undefined问题排查

1. 确认请求是否按规范携带Token #

OAuth2PasswordBearer默认仅识别Authorization请求头，格式必须严格为 Bearer <你的JWT Token>，缺少Bearer 前缀或未添加该请求头，都会导致Token提取失败。

• 正确示例：Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
• 不要将Token放在URL参数、请求Body等位置，默认逻辑不会读取这些区域的内容。

2. 检查tokenUrl路径配置是否正确 #

你的代码中tokenUrl="api/token"，需确保该路径对应的Token生成接口可用：

• 若应用部署在根路径，完整的Token接口路径应为/api/token，需确认该端点存在且能正常返回有效JWT。
• 若应用在子路径（如/v1）下部署，需同步修改tokenUrl为对应路径（如v1/api/token），否则Swagger等自动授权流程会出错，无法获取有效Token。

3. 排查前端传参的常见错误 #

前端调用接口时容易踩的坑：

• 直接将Token值填入Authorization头，遗漏Bearer 前缀；
• 将Token放在自定义字段（如Body中的token键），不符合OAuth2规范，默认提取逻辑无法识别。

4. 排除解码函数的干扰 #

虽然你是先打印Token，但可暂时注释掉decode_access_token相关代码，仅保留打印逻辑，确认Token本身是否未被提取，而非解码过程导致的异常。

快速验证方法 #

用curl直接发送请求测试：

curl -H "Authorization: Bearer 你的有效JWT" http://localhost:8000/你的受保护接口路径

若此时Token能正常打印，说明问题出在前端传参；若仍显示undefined，检查受保护路由是否正确绑定了Depends(get_current_user)，示例如下：

@app.get("/protected")
def get_protected_data(current_user: dict = Depends(get_current_user)):
    return {"user": current_user}

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