SharePoint CSOM KeywordQuery报错：QueryText字段或属性不存在

核心问题分析 #

这个异常本质是搜索请求的API调用方式不匹配，或者权限/API版本配置错误，导致服务器无法识别QueryText属性。其他文件/文件夹操作正常说明基础客户端凭证认证没问题，问题集中在搜索模块的调用逻辑上。

具体解决步骤 #

1. 改用PnP.Framework原生搜索API #

不要混用原生CSOM的KeywordQuery等旧对象，直接使用PnP封装的SearchQuery和context.Search.Query()方法，这是适配最新版本的正确方式：

using PnP.Framework;
using PnP.Framework.Search;
using PnP.Framework.Authentication;

// 初始化客户端凭证认证
var authProvider = new AzureADClientSecretAuthenticationProvider(
    "<你的租户ID>",
    "<你的客户端ID>",
    "<你的客户端密钥>");

var contextOptions = new PnPContextOptions
{
    SiteUrl = "https://<租户>.sharepoint.com/sites/<站点名称>",
    AuthenticationProvider = authProvider,
    // 强制使用SPO REST API，避免Graph API的字段映射问题
    GraphFirst = false,
    ApiVersion = PnP.Framework.Enums.ApiVersion.v1_0
};

using (var context = new PnPContext(contextOptions))
{
    // 构建搜索查询
    var searchQuery = new SearchQuery
    {
        QueryText = "contentclass:STS_Document OR contentclass:STS_Folder",
        SelectProperties = new List<string> { "Title", "Path", "ContentClass" },
        RowLimit = 100
    };

    // 执行搜索
    var searchResults = context.Search.Query(searchQuery);

    // 遍历结果
    foreach (var result in searchResults.PrimarySearchResults)
    {
        Console.WriteLine($"名称: {result["Title"]} | 路径: {result["Path"]}");
    }
}

2. 检查应用权限配置 #

确保Azure AD应用注册中已添加SharePoint应用权限：

• 添加Sites.Search.All（针对站点级搜索）或Search.All（租户级搜索）
• 必须由租户管理员完成权限同意操作

3. 验证API版本与Graph优先设置 #

• 强制指定ApiVersion = v1_0，避免使用预览版API导致属性不兼容
• 设置GraphFirst = false，强制走SharePoint REST API而非Graph API（Graph搜索的请求字段与SPO REST不同，容易引发属性不存在的问题）

4. 排查代码中的错误赋值 #

如果之前混用了原生CSOM对象（比如KeywordQuery），检查是否错误地给某个不包含QueryText属性的对象设置了该值，这类错误会导致请求序列化后服务器无法识别字段。

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