通过应用更新Azure AD用户头像出现MailboxNotEnabledForRESTAPI错误

AI 小北

2026-10-6

解决方案

替换Graph API版本为beta
你当前调用的v1.0版本接口，用户头像更新回退机制仅对已启用Exchange Online邮箱的用户生效，无邮箱的纯AAD用户触发报错后不会执行后续AAD头像更新操作。将接口路径中的v1.0替换为beta即可触发完整的回退逻辑，修改后的请求路径示例：
https://graph.microsoft.com/beta/users/USERLOGIN@MAIL.COM/photo/$value
原有代码仅需修改fetch请求的URL即可，其余配置无需调整。
备用方案：直接更新AAD原生存储的头像属性
如果担心beta版接口的稳定性，可以直接操作AAD用户的thumbnailPhoto属性，该属性完全由AAD存储，不涉及Exchange邮箱逻辑，不会触发上述报错，示例代码如下：

export const updateUserProfileImage = async (file) => {
    // 将图片文件转为Base64编码
    const getBase64 = (file) => new Promise((resolve, reject) => {
        const reader = new FileReader();
        reader.readAsDataURL(file);
        reader.onload = () => resolve(reader.result.split(',')[1]);
        reader.onerror = reject;
    })
    const base64Img = await getBase64(file);
    const headers = new Headers();
    const bearer = `Bearer ###TOKEN###`
    headers.append("Authorization", bearer);
    headers.append("Content-Type", "application/json");
    const options = {
        method: "PUT",
        headers: headers,
        body: JSON.stringify({
            thumbnailPhoto: base64Img
        })
    };
    return fetch(`https://graph.microsoft.com/v1.0/users/USERLOGIN@MAIL.COM`, options)
}

注意：该方案读取头像时同样直接读取thumbnailPhoto属性即可，前端展示逻辑无需做大的调整。