如何修复PowerApps人员选择器组合框搜索异常：支持实时或回车触发

一、优化实时搜索（降低API调用频率） #

1. 启用延迟输出
   选中你的现代组合框，在属性面板找到DelayOutput，设置为true。可调整延迟时间（默认500ms），避免每输入一个字符就触发API请求，减少调用频率缓解延迟。

2. 优化Items属性代码
   把过滤逻辑整合到SearchUserV2的API参数中，减少客户端数据处理量：

Office365Users.SearchUserV2(
    {
        searchTerm: Trim(Self.SearchText),
        isSearchTermRequired: false,
        filter: "accountEnabled eq true and not(userPrincipalName contains '#EXT#')"
    }
).value

原代码的Filter操作会在客户端处理所有返回数据，现在把过滤逻辑交给Office 365 API，返回结果直接是符合条件的用户，提升响应速度。

二、改用回车触发搜索（彻底规避频繁请求） #

如果实时搜索仍不稳定，可切换为回车触发模式：

1. 添加一个文本输入框（命名为txtSearchUser）作为搜索入口，将组合框的ShowSearch属性设为false，隐藏内置搜索框。
2. 给文本输入框的OnKeyUp属性添加以下逻辑：

If(
    Key.Enter in Self.SelectedKeys,
    UpdateContext({varSearchTerm: Trim(Self.Text)})
)

3. 修改组合框的Items属性：

Office365Users.SearchUserV2(
    {
        searchTerm: varSearchTerm,
        isSearchTermRequired: false,
        filter: "accountEnabled eq true and not(userPrincipalName contains '#EXT#')"
    }
).value

仅在按下回车时触发搜索，完全避免输入过程中的频繁API调用。

三、本地缓存用户列表（适配小型组织） #

若组织用户数量≤999，可一次性加载符合条件的用户到本地集合，搜索直接在本地进行：

1. 在App的OnStart属性中加载用户：

ClearCollect(
    colEnabledUsers,
    Office365Users.SearchUserV2(
        {
            searchTerm: "",
            isSearchTermRequired: false,
            filter: "accountEnabled eq true and not(userPrincipalName contains '#EXT#')"
        }
    ).value
)

2. 组合框的Items属性改为：

If(
    Trim(Self.SearchText) = "",
    colEnabledUsers,
    Filter(
        colEnabledUsers,
        StartsWith(DisplayName, Trim(Self.SearchText)) || 
        StartsWith(Mail, Trim(Self.SearchText)) ||
        StartsWith(UserPrincipalName, Trim(Self.SearchText))
    )
)

本地搜索几乎无延迟，且不受API调用限制影响。

四、排查常见问题 #

• 检查Office365Users连接器权限：确保连接器拥有读取用户基本信息的权限，权限不足会导致请求延迟或失败。
• 确认组合框的SearchFields属性：设置为["DisplayName", "Mail", "UserPrincipalName"]，让搜索匹配多字段，输入"Sam"时能正确找到对应用户。
• 清除PowerApps缓存：点击顶部菜单「文件」→「设置」→「高级」→「清除缓存」，重新发布应用，解决缓存引发的异常。

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