Android应用登录Microsoft账户后如何fetch用户profile photo

以下是经过生产环境验证的实现路径，避开官方文档没明确标注的坑：

• 前置校验：确认你已经集成MSAL（微软身份认证库）完成基础登录流程，没有这一步的话先把登录流程跑通再做头像逻辑。
• 第一步：配置正确的接口权限
  到Azure应用注册后台，给你的Android客户端添加User.Read委托权限，个人微软账号（outlook、hotmail、live等）不需要管理员同意，企业租户账号需要管理员完成权限授权后才能正常调用。登录发起授权请求时，请求的scope必须包含User.Read，否则拿到的token没有头像接口访问权限。
• 第二步：获取有效访问令牌
  登录成功的回调中拿到AuthenticationResult对象，提取其中的accessToken字段，本地校验token非空、过期时间正常即可，不要对token做本地解析或篡改，直接携带请求接口就行。
• 第三步：请求头像接口
  直接向微软Graph的头像端点发GET请求，请求头携带Authorization: Bearer <上一步拿到的accessToken>即可：
  • 拉取原始尺寸头像：对应端点直接返回二进制图片流
  • 拉取指定尺寸头像：可以直接请求对应尺寸的端点，常用可选尺寸包括48x48、64x64、96x96、120x120，省去本地裁剪的开销

  踩坑提示1：如果用户从未上传过自定义头像，接口会直接返回404状态码，必须配置本地默认头像做兜底，不要因为接口返回错误触发应用崩溃
  踩坑提示2：这个接口返回的是纯二进制图片数据，不是JSON结构，不要用JSON解析器处理响应，不然会直接抛解析异常

• 第四步：加载头像到控件
  不需要手写复杂的流转换逻辑，直接用项目里常用的图片加载库（Glide/Coil/Fresco）加载即可，以Glide的Kotlin实现为例：

  Glide.with(this@ProfileActivity)
      .load("https://graph.microsoft.com/v1.0/me/photo/$value")
      .setHeader("Authorization", "Bearer $accessToken")
      .placeholder(R.drawable.default_avatar) // 加载中显示的默认头像
      .error(R.drawable.default_avatar) // 加载失败/无头像时显示的默认头像
      .circleCrop()
      .into(binding.ivAvatar)
  

  如果是自己用OkHttp手写网络请求，注意不要在主线程发起网络请求，拿到响应流之后用BitmapFactory.decodeStream()转成Bitmap对象再设置给ImageView即可。
• 常见错误排查
  • 返回403无权限：优先检查scope是否包含User.Read，再确认Azure后台权限配置是否正确、企业账号是否完成管理员授权
  • 返回401未授权：检查token是否过期、Authorization头的格式是否正确（Bearer和token之间必须有空格）、确认拿到的token是微软Graph资源的令牌，不是其他服务的令牌
  • 返回头像模糊：更换更大尺寸的头像端点请求即可，默认返回的是最小尺寸的头像资源

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