分类目录（父级目录）文章数统计错误

[17lhf]

前置条件

• 已经在 issues 列表中搜索了相关问题。
• 这是 Halo 项目本身存在的问题，如果是非项目本身的问题（如：安装部署问题），建议在 Discussions 提交。
• 已经尝试过停用所有的插件，排除是插件导致的问题。
• 如果是插件和主题的问题，请在对应的插件和主题仓库提交。

系统信息

• 外部访问地址: https://yokila.com
• 启动时间: 2024-11-09 22:45
• 版本: 2.20.8
• 构建时间: 2024-10-30 16:29
• Git Commit: 0d1a099
• Java: OpenJDK Runtime Environment / 17.0.12+7-Ubuntu-1ubuntu222.04
• 数据库: Source distribution / 8.0.34
• 操作系统: Linux / 5.15.0-92-generic
• 已激活主题: Earth 1.11.1
• 已启动插件:
  • 文章限制阅读 1.4.3
  • 应用市场 1.8.0
  • Data Studio（数据工厂） 1.0.0-alpha.2
  • 图库管理 1.4.0
  • lightgallery.js 灯箱 1.2.1
  • highlight.js 代码高亮 1.3.2
  • 瞬间 1.8.0
  • 搜索组件 1.6.2
  • 评论组件 2.5.1
  • Markdown / HTML 内容块 1.2.0

使用的哪种方式运行？

Fat Jar

发生了什么？

• 已检查未对子分类开启“阻止文章级联查询”。
• 所有文章只归属单个“子分类”，未设置归属多个“子分类”或者同时归属“父分类”。
• 部分文章开启了 “私有”，目测下来“私有”文章不显示在访客页面的目录栏统计里（此时子分类的统计数已经自动过滤了私有文章），应该也不是这个的问题。
• 目前发现现象：父分类的文章统计数显示， 控制台的管理页面 和 访客浏览页面，都有 部分父分类显示文章数统计值错误。
  
  
• 目前不清楚是不是版本升级导致的历史数据遗留问题？还是实时统计出错？

复现步骤

No response

相关日志输出

附加信息

• 现在虽然父分类文章数显示错误（显示不对，或者为0），但是实际在访客页面选择这个父分类的话（从 “分类目录” 中选择），是可以看到显示完整的所有子分类文章。例如虽然显示数目是 0 ，但是实际观察是显示了所有子分类加在一起的 25篇文章。（印象中 1.x 版本的时候，大概是24年上半年的时候，点击父分类，若没有把文章直接同时归属父分类，是不会显示子分类文章的来着？）
• 另外，实测，假如我把某篇文章同时归属 子分类 和 父分类，则父分类的文章统计数将变成 1。然后我再把这个文章改为只归属子分类（去除归属父分类），则父分类文章统计数将变成 0 .（上图中那个父分类文章数 = 0 ，就是这么弄出来的）

[ruibaby]

cc @guqing

/kind bug
/area core

[guqing]

我通过以下能够查询文章数汇总的表达式显示了第一层级的文章数量如下图左侧红框所示

<p th:each="category : ${categoryFinder.listAsTree()}">
  <span th:text="${category.spec.displayName}"></span>
  <span th:text="${category.postCount}"></span>
</p>

因此可以看出 earth 主题可能是没有使用后端计算的数量

需要注意的是：
在 Console 用户界面中，分类下显示的文章数量仅统计该分类本身直接关联的文章数量，不包含其子分类的文章数量。这样可以更加直观地查看每个分类的具体文章数。例如：

• 如果文章 A 直接属于分类 摘录，则 摘录 的文章数量为 1。
• 如果文章 A 属于子分类 常规摘录，而 摘录 本身没有直接关联的文章，则 摘录 的文章数量为 0。

所以需要确认两点：

1. @17lhf 关于你图中 摘录 分类所属的直接关联文章是否确实为 0，以及 风袭异录 的直接关联文章是否确实为 35，并关注上述文章数量计算规则是否与实际数量情况符合，如果根据规则数量还是不正确则为 bug
2. @ruibaby 需要确认以下 earth 的分类数量显示是怎么计算的，是否为后端的问题

[ruibaby]

需要确认以下 earth 的分类数量显示是怎么计算的，是否为后端的问题

不是算的，直接取的 status.visiblePostCount，https://github.com/halo-dev/theme-earth/blob/f5d2d756162c8fc5675dba8ac7fffa2f3c04fa3c/templates/modules/category-tree.html#L11

这个 status.visiblePostCount 和 postCount 到底应该怎么区分呢，这很容易造成误导，文档也没有写明白这个问题，现在一共三个代表文章数量的字段。

[guqing]

这个 status.visiblePostCount 和 postCount 到底应该怎么区分呢，这很容易造成误导，文档也没有写明白这个问题，现在一共三个代表文章数量的字段。

status 中的文章数量是属于分类的直接关联的，postCount 是所有（包括私有、草稿、回收站），而 visiblePostCount 用在主题端是公开的文章数量,外层的 postCount 是属于分类树的节点的会汇总子节点文章数量，在主题端使用一般不需要去关系 status 中的值,永远取外层的即可一般都会提供在 VO 中，比如 CategoryVo 和 CategoryTreeVo 都是有在外层提供 postCount 直接用，不需要告诉主题开发者 status 有什么

[ruibaby]

但我感觉这样还是有点混乱，和其他地方有些区别，并且有些字段本来就是要在 status 获取的，比如 permalink。

any way，先改文档吧，晚点我检查所有主题的写法。

[guqing]

但我感觉这样还是有点混乱，和其他地方有些区别，并且有些字段本来就是要在 status 获取的，比如 permalink。

any way，先改文档吧，晚点我检查所有主题的写法。

确实需要改一下文档，把字段的作用介绍清楚就好了，虽然主题也可以直接取 status.visiblePostCount 但是也分场景，因为如果是平铺的话那就是取这个字段合适，如果是树状那就是外层的 postCount 合适，这取决于具体用途

[ruibaby]

能全部改成外层的 postCount 吗？不管是不是平铺

[guqing]

能全部改成外层的 postCount 吗？不管是不是平铺

可以，分类和标签都可以，如果是 CategoryTreeVo 外层 postCount 就是汇总的,CategoryVo适合平铺场景是单独的,TagVo也有，因此对于分类和标签的文档，可以隐去 status 中的部分字段的文档不写已简化理解成本