Microsoft Graph API $search搜索displayName不支持包含匹配问题咨询

问题原因确认 #

你遇到的现象不属于API使用疏漏，当前Microsoft Graph V1.0版本的用户接口$search查询针对displayName属性的匹配逻辑确实仅支持整字段前缀匹配（startsWith）和整字段后缀匹配（endsWith），不支持字段中间内容的contains包含匹配，同时对混合多语言、带特殊符号的字段不会做子段分词独立匹配，完全符合你测试的结果：

• 搜索이선匹配整字段前缀，返回正确结果
• 搜索Annie、Lee属于字段中间内容，不触发匹配规则
• 搜索Lee)匹配整字段后缀，返回正确结果

现有$search能力确实没有实现多数开发者预期的全字段模糊匹配功能，和$filter已有的startsWith、endsWith能力重合度较高，属于官方能力的局限。

适配解决方案 #

针对你的多语言混合displayName搜索场景，可根据业务实际情况选择以下方案：

• 本地缓存全量检索：如果你的组织用户规模在10万量级以内，可定期调用全量用户接口拉取id、displayName等核心检索字段存储在本地数据库/缓存中，直接在本地做contains模糊匹配，匹配到对应id后再调用Graph API获取用户的完整信息。该方案可100%满足自定义模糊搜索需求，性能也可控。
• 拆分字段独立存储：可借助Microsoft Graph的用户自定义扩展属性能力，将韩文名、英文名分别存储到独立的自定义字段中，搜索时分别对两个字段调用$filter的startsWith运算符做匹配，合并返回结果即可解决中英文混合搜索的问题。
• 业务侧规则适配：如果无法调整存储逻辑，可在搜索入口增加提示，引导用户搜索韩文时输入姓名前缀、搜索英文时输入完整英文名加后缀括号，适配当前API的匹配规则。

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