Neos CMS 7问题：新建节点在文档树中消失，需清缓存恢复

没错，Neos CMS后台的文档树确实存在专门的缓存机制，你遇到的这个节点莫名消失的问题，本质就是文档树相关缓存没有及时失效导致的。

问题原因分析 #

你描述的场景：在Home节点下创建「Neos CMS」和「Blog」页面后，预览主菜单显示正常，但点击其中一个节点时「Blog」会消失，只有点击Home节点或手动刷新树才会暂时重现，直到执行./flow flow:cache:flush全局清缓存才永久显示——这种情况在部分Neos发行版（包括你提到的CodeQ Skeleton和官方Base Distribution）里确实存在，属于文档树缓存同步的异常问题。

Neos后台文档树依赖Neos_Neos_Backend_TreeCache这个专用缓存池来存储节点树的结构数据，理论上节点创建、更新后，系统会自动触发缓存失效，但在某些配置或版本场景下，可能出现以下情况：

• 节点变更的事件钩子没有正确触发缓存清理逻辑
• 缓存后端（比如文件缓存、Redis）的配置存在延迟或失效异常
• 局部缓存的粒度控制问题，导致子节点的缓存没有被正确更新

解决方案 #

1. 精准清理文档树缓存
   不用每次都全局清缓存，只针对文档树缓存执行清理命令即可，速度更快且不影响其他缓存：

   ./flow cache:flush Neos_Neos_Backend_TreeCache
   

2. 检查缓存配置
   打开项目的Settings.yaml，查看Neos.Neos.Caching.Backend.TreeCache相关配置，确认缓存后端的设置是否正确，比如是否开启了cacheAnnotations或其他可能影响自动失效的配置。

3. 验证事件监听器
   确保Neos\Neos\Domain\Service\ContentCacheFlusher服务正常注册并工作，这个服务负责在节点发生变更时，同步清理相关的前端和后台缓存。可以通过./flow configuration:show Neos.Neos.eventListeners命令查看相关监听器的状态。

4. 提交复现脚本协助官方修复
   既然你已经有可复现问题的bash脚本，建议提交到Neos官方的GitHub仓库issue中，因为已有其他用户确认官方发行版也存在该问题，这很可能是一个需要官方修复的bug，你的复现脚本会极大帮助开发团队定位根源。

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