排查后台有内容但页面未显示

08 页面构建器 / 08.03 发布与验证

先选一篇内容作为检查对象

后台有文章，前台不一定会显示。页面使用的数据来源、分类、语言、网站范围和访问条件，都可能影响结果。先确认页面是否能查到这篇内容，再调整模块外观。

准备一篇可以明确核对的文章，记录内容 ID、发布状态、语言、分类和实际网址。需要修改内容或页面配置时，使用有相应编辑权限的账号；验证访客效果时，再换成访客或目标用户身份。

检查构建器里的数据来源

打开目标网站的构建器，选择没有显示内容的文章列表模块，在内容设置中查看「数据来源」。

设置	检查方法
常规列表	核对列表使用的分类、筛选条件和内容类型，确认测试文章属于这个范围。
当前内容相关	核对当前页面对应的内容及相关内容条件。它与普通文章列表的数据来源不同，不能只根据后台文章总数判断结果。
分类菜单	确认所选分类正确。使用多分类分栏布局时，分类菜单的顺序也是各列的顺序。
总数量	核对显示数量是否符合预期。文章存在但未排进当前显示范围，也可能看不到。
默认排序	未选择筛选排序时使用默认值；用户选择排序后，优先使用筛选值。

修改后发布配置，再到真实页面检查。构建器预览中的示例内容不能证明真实查询一定有结果。

检查发布状态、语言和网站范围

1. 在 WordPress 内容编辑页确认目标记录已经发布。原文发布，不代表对应译文也已发布。
2. 核对真实页面当前使用的语言，找到该语言的文章记录，检查标题、分类和内容是否正确。
3. 检查分类的语言关联。列表按目标语言转换分类条件时，如果找不到对应分类，会返回空结果，不会自动放开分类条件显示全部文章。
4. 核对目标前端的分类范围。同一后台下，一篇文章可能符合 A 网站范围，却不符合 B 网站范围。
5. 重新打开实际网址，确认这篇文章是否出现。

复制或建立译文后，应检查目标记录。不要只改原文模板，也不要假定分类关联、导航和所有字段都会自动准备好。

按页面现象继续排查

现象	优先检查
整个页面显示 404	核对完整网址、当前语言的内容记录、发布状态，以及目标网站是否允许显示该内容。
页面正常，但列表为空	检查模块的数据来源、分类、筛选条件、当前语言和目标网站范围。
标题显示，但没有下载内容	到文章编辑页检查是否配置资源，再检查页面是否有对应下载模块，以及当前用户是否满足资源访问条件。
原文有，译文没有	检查译文是否存在并已发布，再核对目标语言的分类和关联关系。
管理员能看，普通用户不能看	比较两种身份对应的阅读、资源或用户组条件，不要仅用管理员账号判断访客效果。
预览有，真实页面没有	确认配置发布成功、访问的网站正确，再检查前端配置更新和缓存。

确认问题已解决

每次只改一个条件，再用同一篇内容、同一个网址和同一种用户身份验证。内容出现后，再恢复正常数量和筛选方式，检查结果是否仍符合预期。

不要为了让文章出现就取消全部权限，或清空所有前端分类限制。这样会扩大内容展示范围，也难以判断原来的问题在哪里。

需要他人协助时，提供实际页面网址、语言、内容 ID、分类、用户身份、配置保存时间和错误提示。不要提供密码或接口密钥。