Drupal站点面包屑缓存异常及注入实现优化咨询

首先，你的面包屑消失问题确实和当前的注入方式密切相关，核心原因是缓存元数据没有正确传递，导致Drupal的缓存系统无法识别页面和面包屑块之间的依赖关系。

为什么当前方式会导致缓存问题？ #

你在.theme文件里直接加载面包屑块并赋值给$variables['content']['breadcrumbs']，这种做法只把块的渲染结果塞到了页面变量里，但没有把块的缓存标签、缓存上下文等元数据合并到页面的缓存信息中。Drupal的缓存系统完全依赖这些元数据来判断什么时候需要刷新缓存：

• 部署代码后，面包屑块的配置或关联逻辑可能发生变化，但页面缓存因为没有记录对这个块的依赖，不会自动失效；
• 加上Varnish的页面级缓存，旧的缓存页面里根本没有面包屑的内容，必须多次清缓存+强制刷新才能让新的渲染结果生效。

更优的实现方案 #

根据你的需求（不同节点类型/页面显示不同位置的面包屑），推荐以下几种方案，优先级从高到低：

1. 优先用Drupal内置的块布局+可见性条件（零代码最可靠） #

这是最符合Drupal最佳实践的方式，完全不需要手动注入代码，缓存自动处理：

• 进入结构 -> 块布局；
• 找到你需要放置面包屑的区域（比如内容区域的顶部/中间，甚至可以为特定节点类型创建自定义区域）；
• 添加「面包屑」块，然后在可见性条件里设置规则：
  • 比如选择「内容类型」，指定只在特定节点类型显示；
  • 或者选择「路径」，匹配特定页面路径；
• 保存配置后，Drupal会自动管理面包屑的缓存依赖，部署后只需清一次缓存（如果配置是同步的，甚至可能自动生效）。

2. 改进preprocess代码，正确传递缓存元数据 #

如果必须用代码注入的方式（比如面包屑要和节点内容深度交错），一定要合并缓存元数据：

use Drupal\Core\Render\BubbleableMetadata;
use Drupal\block\Entity\Block;

function YOUR_THEME_preprocess_page(&$variables) {
  $block = Block::load('breadcrumbs');
  if ($block) {
    // 获取块的渲染数组
    $block_render = \Drupal::entityTypeManager()->getViewBuilder('block')->view($block);
    
    // 把块的缓存元数据合并到页面变量中
    if (!empty($block_render['#attached'])) {
      $variables['#attached'] = BubbleableMetadata::mergeAttachments(
        $variables['#attached'] ?? [],
        $block_render['#attached']
      );
    }
    // 合并缓存标签
    if (!empty($block_render['#cache']['tags'])) {
      $variables['#cache']['tags'] = array_merge(
        $variables['#cache']['tags'] ?? [],
        $block_render['#cache']['tags']
      );
    }
    
    $variables['content']['breadcrumbs'] = $block_render;
  }
}

这样页面缓存会记录对面包屑块的依赖，当块的配置变化时，页面缓存会自动失效，不需要多次清缓存。

3. 自定义面包屑生成器（高度定制场景） #

如果需要完全自定义面包屑的内容和结构（比如和节点字段联动），可以创建自定义的面包屑生成器：

• 创建一个自定义模块，实现BreadcrumbBuilderInterface；
• 在build()方法里生成符合需求的面包屑链接；
• 通过getCacheContexts()和getCacheTags()方法返回正确的缓存元数据；
• 最后在对应的模板（比如page--node--[type].html.twig）里直接渲染{{ breadcrumb }}即可。
  这种方式完全集成到Drupal的面包屑系统中，缓存处理最彻底，适合复杂的定制需求。

总结 #

当前的注入方式因为忽略了缓存元数据传递，导致缓存失效机制失效，才需要多次清缓存才能恢复。优先推荐用块布局+可见性条件的零代码方案，既可靠又易维护；如果必须用代码，一定要记得合并缓存元数据。

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