IPageRetriever在Ajax调用下无法返回数据的原因排查

核心原因推测 #

你的代码在页面加载的Index方法中能正常返回数据，但Ajax调用的接口返回0条，大概率是以下几个原因：

1. 站点上下文未正确初始化 #

Kentico的SiteContext.CurrentSiteName在页面请求流程（比如Index方法）中会自动初始化，但直接的Ajax API请求可能不会触发站点上下文的加载流程，导致SiteContext.CurrentSiteName为空或值不正确，最终OnSite过滤条件匹配不到任何数据。

验证方式：在Ajax接口方法中添加日志，输出SiteContext.CurrentSiteName的值：

ErrorHandler.EventLog.LogInformation("AjaxSiteName", SiteContext.CurrentSiteName ?? "空值");

如果日志显示为空，就能确认是这个问题。

解决办法：

• 单站点场景：直接硬编码站点代码代替SiteContext.CurrentSiteName，比如OnSite("YourSiteCode")（站点代码可在Kentico后台查看）。
• 多站点场景：从请求头或URL参数中传递站点标识，或者手动初始化站点上下文：

  SiteContext.CurrentSite = SiteInfoProvider.GetSiteInfo("YourSiteCode");
  

2. 异步调用的错误用法 #

你在同步方法中使用RetrieveAsync<T>().Result获取异步结果，这种同步阻塞异步的写法可能导致线程死锁或未正确获取查询结果，虽然Index方法（async）中这么用没出问题，但同步方法的风险更高。

解决办法：把Ajax接口改成异步方法，用await正确处理异步调用：

[HttpPost]
[Route("VillageNewsList/VillageNewsItemList")]
public async Task<VillageNewsListViewModel> VillageNewsItemList(string NodeAliasPath = "", int villageId = 0, string state = "", int page = 1, int pageSize = 4)
{
    try
    {
        var newsList = await pagesRetriever.RetrieveAsync<VillageNewsItem>(
            query => query
                .Path("/Home/Village-News", PathTypeEnum.Children)
                .Published(true)
                .OnSite(SiteContext.CurrentSiteName)
                .OrderByDescending(x => x.DocumentCreatedWhen)
        );

        return new VillageNewsListViewModel
        {
            VillageNewsItems = newsList?.ToList()
        };
    }
    catch (Exception ex)
    {
        ErrorHandler.EventLog.LogError(ex.Source, ex.Message, ex.StackTrace);
    }
    return null;
}

3. 用户权限上下文不一致 #

页面请求的Index方法中，用户上下文是当前访问的匿名/登录用户，但Ajax请求可能没有正确传递用户身份，或者Kentico的权限检查逻辑在API请求中与页面请求不同，导致查询被权限过滤。

验证方式：临时在查询中添加.AllowAll()跳过权限检查，看是否能返回数据：

query => query
    .Path("/Home/Village-News", PathTypeEnum.Children)
    .Published(true)
    .OnSite(SiteContext.CurrentSiteName)
    .AllowAll() // 临时测试，生产环境移除
    .OrderByDescending(x => x.DocumentCreatedWhen)

如果添加后能返回数据，说明是权限问题，需要确保Ajax请求的用户上下文有访问这些新闻页面的权限。

4. 路径解析差异 #

极少数情况下，API请求的上下文对站点根路径的解析与页面请求不同，导致/Home/Village-News路径无法匹配到对应节点。

解决办法：改用节点ID查询代替路径查询，避免路径解析问题：

// 先获取Village-News节点的ID（可从Kentico后台或代码中获取）
int villageNewsNodeId = 123;
query => query
    .WhereEquals("NodeID", villageNewsNodeId)
    .PathType(PathTypeEnum.Children)
    .Published(true)
    .OnSite(SiteContext.CurrentSiteName)
    .OrderByDescending(x => x.DocumentCreatedWhen)

排查步骤建议 #

1. 先检查SiteContext.CurrentSiteName在Ajax接口中的值，确认站点上下文是否正确。
2. 移除OnSite条件测试，看是否能返回数据。
3. 修正异步调用的写法，用await代替.Result。
4. 临时添加.AllowAll()排查权限问题。

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