首次调用/oidc/me端点返回address字段为null的排查方法

按优先级从高到低依次排查：

• 核对授权请求的权限配置
  当前授权请求携带的scope为openid profile email，未包含OIDC标准中对应地址字段的address scope。多数OIDC平台的权限校验逻辑要求，即使在claims参数中显式声明需要返回某字段，也必须先获得对应scope的授权。部分平台的scope权限同步存在秒级延迟，会出现首次调用时权限未生效、后续权限同步完成后字段正常返回的现象。
• 检查claims参数的写法合规性
  当前claims参数中对address字段的赋值为null，不符合OIDC规范中claims参数的标准写法。如果需要强制返回该字段，应配置为"address": {"essential": true}。部分平台对非标准写法的参数解析存在兼容逻辑缺陷，首次请求时可能将null识别为“不需要返回该字段”，后续请求命中用户信息缓存后才会带出全量字段。
• 验证接口侧异步聚合/冷加载逻辑
  该现象是典型的后端异步数据拉取特征：/oidc/me接口的地址数据存储在独立的下游用户档案服务中，首次调用时接口触发下游数据拉取，若下游响应超时会触发降级逻辑直接返回null，同时将拉取成功的地址数据写入短周期缓存；1分钟内的后续调用直接读取缓存，因此可以正常返回数据。对比首次、二次调用的接口响应耗时，通常首次调用耗时会明显高于二次调用，查后端日志能看到首次请求时下游服务的超时/熔断记录。
• 排查token签发后的claim异步填充逻辑
  部分平台在/oidc/token接口签发access token后，会异步拉取用户全量claim写入token关联的缓存，不会阻塞token返回流程。如果拿到token后立刻调用/oidc/me，此时异步拉取任务尚未完成，缓存中不存在address字段就会返回null；等待几十秒异步任务执行完成、缓存填充完毕后，后续请求就能正常返回字段。做对照测试即可验证：拿到access token后等待90秒再发起第一次/oidc/me调用，如果此时address字段直接正常返回，即可确认是该问题。
• 排查网关层权限同步延迟
  检查API网关的用户权限同步逻辑：部分网关在首次收到携带新access token的请求时，会异步拉取该token对应的权限列表，首次请求时权限列表尚未同步完成，判定调用方没有地址字段的读取权限因此返回null；等权限列表同步到网关节点后，后续请求就能正常返回字段。
• 做用户维度的对照测试
  选取不同活跃度的用户重复相同调用流程，如果仅长期未登录的用户存在该问题，基本可以确认是用户冷数据从归档存储加载到在线存储的延迟导致。

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