Drupal9如何实现全页面支持带/不带路径前缀的双URL访问

核心思路：放弃逐页配置URL别名的思路，用「路由层自动适配前缀+全局上下文判断切换渲染」的方案，一次配置全站生效，覆盖所有现有内容页、自定义模块路由、Views生成页面，后续新增内容无需额外配置。 #

方案一：零代码服务器配置实现（工作量最小，10分钟搞定） #

如果你的站点用Nginx/Apache做web服务器，直接在服务器层做前缀转发，不需要改Drupal后台任何配置：

• 配置服务器转发规则，将所有带/something/前缀的请求，内部转发到对应无前置的路径，同时给请求打嵌入模式标记。
  Nginx配置示例：

  location ^~ /something/ {
      # 内部重写到去掉前缀的原路径，用户浏览器地址栏URL保持不变
      rewrite ^/something/(.*)$ /$1 last;
      # 传递嵌入模式标记到PHP层
      fastcgi_param HTTP_X_EMBED_MODE 1;
  }
  

  Apache规则可以直接在.htaccess里加：

  RewriteRule ^something/(.*)$ /$1 [L,E=HTTP_X_EMBED_MODE:1]
  

• 主题层加渲染判断：编辑你当前主题的page.html.twig模板，通过请求头判断是否为嵌入模式，非嵌入模式才渲染header、侧边栏、footer等公共组件：

  {# 仅普通访问模式渲染页头 #}
  {% if not app.request.headers.get('X-Embed-Mode') %}
    {{ page.header }}
    {{ page.primary_menu }}
  {% endif %}
  
  {# 主内容区所有模式都正常渲染 #}
  <main class="main-content">
    {{ page.breadcrumb }}
    {{ page.content }}
  </main>
  
  {# 仅普通访问模式渲染侧边栏和页脚 #}
  {% if not app.request.headers.get('X-Embed-Mode') %}
    {{ page.sidebar_first }}
    {{ page.sidebar_second }}
    {{ page.footer }}
  {% endif %}
  

• 补全缓存配置：在settings.php里添加缓存上下文，避免普通模式和嵌入模式的页面缓存串数据：

  $settings['renderer.config']['auto_placeholder_conditions']['contexts'][] = 'headers:X-Embed-Mode';
  

• 清全站缓存，所有原有页面自动支持/something/原路径访问，带前缀访问时自动隐藏公共组件，完全满足iframe嵌入需求。

方案二：Drupal层自定义模块实现（无服务器配置权限可选） #

如果没有服务器修改权限，建一个轻量自定义模块实现逻辑：

• 注册路由订阅事件，遍历全站所有非后台路由，自动为每个路由注册带/something前缀的镜像路由，同时给镜像路由打_embed_mode = TRUE的标记，核心代码片段：

  // src/EventSubscriber/EmbedRouteSubscriber.php
  public function alterRoutes(RouteCollection $collection) {
    $embed_routes = new RouteCollection();
    foreach ($collection->all() as $name => $route) {
      $path = $route->getPath();
      // 跳过后台、文件、用户登录等不需要嵌入的路径
      if (str_starts_with($path, '/admin') || str_starts_with($path, '/file') || str_starts_with($path, '/user/login')) {
        continue;
      }
      $embed_route = clone $route;
      $embed_route->setPath('/something' . $path);
      $embed_route->setDefault('_embed_mode', TRUE);
      $embed_routes->add($name . '.embed', $embed_route);
    }
    $collection->addCollection($embed_routes);
  }
  

• 实现出站链接修改：实现hook_url_outbound_alter，当检测到当前是嵌入模式访问时，站点内生成的所有链接（包括Views分页、自定义模块链接）自动加上/something前缀，避免嵌入模式下点击链接跳回普通模式。
• 模板层判断逻辑和方案一一致，只是判断条件从请求头改成路由标记：

  {% if not app.request.attributes.get('_embed_mode') %}
    {# 渲染header、footer、侧边栏 #}
  {% endif %}
  

• 同样添加路由相关的缓存上下文，清缓存即可生效。

方案优势 #

• 零逐页配置：现有550+页面、所有自定义模块路由、Views页面自动兼容，不需要手动给每个页面加别名
• 后续新增内容自动适配：以后新建内容、新建Views页面、新增自定义路由，不需要额外配置就自动支持两种访问模式
• 逻辑隔离：嵌入模式和普通模式的渲染逻辑完全独立，不会影响原有站点的正常访问
• 工作量极小：服务器方案10分钟即可配置完成，自定义模块方案总开发量不超过30分钟

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