添加AAD安全组至Power BI工作区遇GroupMemberCountExceedsAllowedLimit错误

1. 排查安全组的嵌套成员与缓存问题 #

• 就算清空了组的直接成员，AAD安全组可能包含嵌套子组，Power BI会递归计算所有嵌套成员的总数，触发限制。去AAD管理中心查看组的「所有成员」，确认有没有隐藏的嵌套成员。
• Power BI可能缓存了组的旧成员数据，等待1-2小时让缓存刷新，或者修改组名/描述触发同步后再尝试添加。

2. 验证Embedded Capacity的权限限制 #

• A1容量对添加的安全组有成员数上限，哪怕组是空的，也可能因为旧属性被标记成大组。新建一个空安全组测试能否添加，排除原组本身的属性问题。
• 检查A1容量的工作区权限模式，如果是「共享模式」，可能存在额外的权限叠加限制，切换为「专用模式」后再测试。

3. 清理工作区的现有权限负载 #

• 工作区的总权限成员数（包括所有用户、嵌套组的递归成员）可能已达上限。统计现有所有权限主体的总人数，先移除部分非必要权限后再尝试添加。
• 清理工作区内重复或失效的权限条目，比如已离职用户、废弃组，再操作添加新组。

4. 检查API调用细节 #

• 使用Rest API添加时，确认参数正确：principalType设为Group，groupUserAccessRight设为Viewer，组的objectID必须准确无误。
• 调用GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users查看工作区现有权限，排查是否存在异常条目；再调用Get Group API查看组的属性，比如isReadOnly是否正常。

5. 后台异常与支持渠道 #

• 若上述操作均无效，可能是Power BI后台的组数据同步异常，或容量配额出现错误。去Power BI管理中心的「容量活动日志」查询相关错误记录。
• 联系微软支持，提供报错的请求ID、组ID、工作区ID和容量ID，让后台团队排查数据不一致问题。

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