New Outlook for Mac共享邮箱调用loadCustomPropertiesAsync失败问题

问题成因 #

1. 版本适配缺陷：你使用的New Outlook for Mac v16.52是2021年发布的早期版本，该版本针对共享邮箱场景的Office.js API未完成适配，默认未开放item级自定义属性的读写权限，底层返回的-2147467259错误属于未放行权限的通用报错。
2. 插件权限配置缺失：如果你的Office插件清单未显式声明支持共享文件夹，也会触发该类权限拦截错误。

解决方案 #

• 优先升级客户端版本 #

  直接升级New Outlook for Mac到v16.66及以上正式版，微软在后续版本已经修复了共享邮箱场景下loadCustomPropertiesAsync接口的适配问题，90%以上同报错用户升级后问题直接消失。

• 修正插件清单配置 #

  检查你的插件manifest.xml配置，做两处调整：
  1. 权限等级至少设置为ReadWriteItem：

  <Permissions>ReadWriteItem</Permissions>
  

  2. 在桌面端适配节点下显式声明支持共享文件夹：

  <DesktopFormFactor>
    <SupportsSharedFolders>true</SupportsSharedFolders>
    <!-- 其余原有配置 -->
  </DesktopFormFactor>
  

• 低版本兼容方案 #

  如果暂时无法升级Outlook客户端，可放弃使用item级自定义属性接口，改用两种替代方案：
  1. 用Office.context.roamingSettings存储全局通用属性，规避item级权限限制
  2. 调用Graph API的扩展属性接口读写消息自定义属性，替代Office.js原生接口能力

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