使用Azure门户/Graph应用令牌更新B2C本地用户头像返回404问题

问题根源 #

你遇到的404报错是Azure AD B2C本地账户调用Graph API头像接口的常见兼容性问题：
/v1.0版本的users/{userOid}/photo系列接口底层依赖Exchange Online的头像存储服务，而B2C本地账户的配置默认存储在B2C独立的用户目录中，不会同步到Exchange地址簿，所以调用v1.0接口时会被识别为无对应头像存储、甚至无对应用户，和你持有的令牌权限、用户是否真实存在无关。

解决方案 #

• 优先改用Beta版本的Graph API接口，微软已在Beta层面对B2C用户的头像读写做了适配，请求地址替换为：
  读头像：https://graph.microsoft.com/beta/users/{userOid}/photo/$value
  写头像：https://graph.microsoft.com/beta/users/{userOid}/photo/$value
• 确认应用已配置正确的API权限：应用权限需勾选User.ReadWrite.All或Directory.ReadWrite.All，且已完成管理员同意；如果使用委派权限，需对应勾选User.ReadWrite/User.ReadWrite.All权限。
• 上传头像时注意校验参数：直接在请求体传入图片二进制内容，支持JPG、PNG格式，单张大小不超过4MB，Content-Type请求头需和图片格式匹配（如image/jpeg），不要使用multipart/form-data格式上传。
• 若操作的是刚创建的B2C用户，建议等待1-3分钟待用户配置同步完成后再调用头像接口，避免同步延迟导致的临时报错。

报错说明 #

• GET请求返回的ImageNotFound错误：本质是v1.0接口找不到B2C用户对应的Exchange头像存储路径，不是用户真的没设置头像。
• PUT请求返回的ErrorUserResolutionFailedUserDoesNotExist错误：是v1.0头像服务在Exchange地址簿中未检索到该B2C本地账户，并非用户在B2C目录中不存在。

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