必须显式传入rsa公钥、指定algorithms=['rs256']、校验issuer和audience，且确保系统时间同步，否则id token验证必失败。
为什么 pyjwt.decode() 直接解码 ID Token 会报错
ID Token 是 JWT，但不是随便用 pyjwt.decode() 解开就行。它必须满足 OIDC 规范的三重校验：签名验证、签发者（iss）和受众（aud）匹配、时间有效性（exp/nbf）。直接传一个未指定算法、没给公钥、跳过校验的 decode() 调用，大概率抛 InvalidSignatureError 或 ExpiredSignatureError。
- 必须显式传入
key（通常是 JWKS 端点获取的 RSA 公钥），不能依赖自动算法探测 - 必须设
algorithms=['RS256']（绝大多数 OIDC 提供方只用 RS256，硬编码比 auto 更安全） - 必须传
issuer和audience参数做字段比对，否则等于没验身份 - 不要设
verify=False—— 这是开发时偷懒最常踩的坑，上线即高危
import jwt
decoded = jwt.decode(
id_token,
key=public_key,
algorithms=['RS256'],
issuer='https://auth.example.com',
audience='my-client-id'
)
如何安全获取并缓存 JWKS 公钥
OIDC 提供方（如 Auth0、Keycloak、Azure AD）把签名公钥放在 /.well-known/jwks.json，但每次请求都去拉它既慢又可能被中间人劫持。得自己缓存并定期刷新。
- 公钥不是静态字符串，是带
kid的 JSON Web Key Set，需按header['kid']匹配具体 key - 缓存必须带 TTL（建议 1 小时），JWKS 可能轮换；别用永久内存变量存
- 刷新失败时应保留旧 key 继续服务，而不是崩掉整个鉴权流程
- 不要用
requests.get()同步调用阻塞主线程；生产环境建议用异步 HTTP 客户端或后台定时任务更新
id_token_hint 和 id_token 验证不是一回事
OIDC 授权码流里收到的 id_token 是后端要验的；而 id_token_hint 是前端在登出请求里传给 OP 的提示参数，它不参与后端 token 验证逻辑，只是供 OP 识别用户会话。
- 后端验证只处理 Authorization Code Flow 返回的
id_token字段（在/token响应体中） -
id_token_hint是 OpenID Connect Session Management 规范里的东西，用在/end_session请求里，后端无需解它、也不该拿它当主凭证 - 混淆这两者会导致你试图验证一个根本没被签发、甚至已被撤销的 token，结果必然是
InvalidAudienceError
时间戳校验失败的常见原因
exp 和 nbf 校验失败，90% 不是因为 token 过期，而是系统时钟不同步。
立即学习“Python免费学习笔记（深入）”；
- Python 默认使用本地系统时间，如果服务器时间比 NTP 时间快/慢 > 60 秒，就会误判过期
- 不要手动加
leeway参数掩盖问题（比如设leeway=120），这会让攻击窗口变大 - 正确做法是确保服务器启用 NTP 同步（
systemd-timesyncd或chrony），并监控时钟偏移量 - 如果真要容错，
leeway最多设 5–10 秒，且仅用于调试阶段
验 ID Token 看似只是调个 jwt.decode()，但每个参数背后都是 OIDC 协议的刚性约束。漏掉 issuer 比漏掉 key 更隐蔽，时钟偏差比签名错误更难定位。
