Magento 2.2.2：基于User Agent实现Varnish差异化缓存需求

当然可以实现！你的问题核心是Varnish默认的缓存键没有区分设备类型，导致不同设备请求命中了同一个缓存条目。下面是针对Magento 2.2.2 + Varnish的完整解决方案，结合Varnish配置和Magento缓存上下文来实现：

1. 配置Varnish，基于设备分类生成缓存键 #

Varnish的缓存键默认由请求URL、主机头等元素组成，我们需要把设备类型加入缓存键的计算逻辑里。不过直接用完整的User Agent会导致缓存条目过多（User Agent变种太多），所以先把User Agent归类为desktop或mobile，再用这个分类值来区分缓存。

修改你的Varnish VCL配置文件（通常是default.vcl），在vcl_recv子例程中添加以下代码：

sub vcl_recv {
    # 检测User Agent并标记设备类型
    if (req.http.User-Agent ~ "(mobile|android|iphone|ipad|blackberry|windows phone)") {
        set req.http.X-Device = "mobile";
    } else {
        set req.http.X-Device = "desktop";
    }
    
    # 将设备类型加入缓存键计算
    set req.hash += req.http.X-Device;
}

这段代码会先通过正则匹配识别移动设备，设置自定义请求头X-Device，再把这个头的值加入Varnish的缓存哈希计算中——这样桌面和移动设备的请求会生成不同的缓存键，从而存储各自的缓存内容。

2. 配置Magento的缓存上下文，关联设备类型 #

Magento的全页缓存（FPC）也需要感知设备类型，这样生成页面时才会输出对应内容。你可以通过自定义模块（或主题配置）添加设备类型到缓存上下文：

步骤2.1：添加缓存上下文定义 #

在你的自定义模块的etc/di.xml（如果没有就创建）中添加以下配置：

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <type name="Magento\Framework\App\Http\Context">
        <arguments>
            <argument name="data" xsi:type="array">
                <item name="device_type" xsi:type="string">device_type</item>
            </argument>
        </arguments>
    </type>
</config>

步骤2.2：在设备检测代码中设置缓存上下文 #

修改你已有的设备检测代码，注入Magento的Http\Context类，把设备类型设置到缓存上下文中：

<?php
namespace Your\Namespace;

use Magento\Framework\App\Http\Context;

class DeviceDetector
{
    protected $httpContext;

    public function __construct(Context $httpContext)
    {
        $this->httpContext = $httpContext;
    }

    public function detectAndSetDeviceContext()
    {
        $userAgent = $_SERVER['HTTP_USER_AGENT'] ?? '';
        $isMobile = preg_match('/(mobile|android|iphone|ipad|blackberry|windows phone)/i', $userAgent);
        
        // 设置设备类型到缓存上下文
        $this->httpContext->setValue(
            'device_type',
            $isMobile ? 'mobile' : 'desktop',
            false
        );
    }
}

确保这段代码在页面渲染前执行（比如通过控制器前置方法、插件或布局事件注入），这样Magento生成页面时会根据设备上下文输出对应内容，同时把设备类型作为缓存的一部分。

3. 验证配置并生效 #

完成上述配置后，执行以下步骤使配置生效：

• 重启Varnish服务，让VCL配置生效；
• 清除Magento所有缓存：bin/magento cache:flush；
• 分别用桌面和移动设备访问目标页面，检查页面输出是否符合预期，同时查看响应头中的X-Device和X-Cache字段，确认不同设备命中的是各自的缓存条目。

注意事项 #

• 可以根据需要调整User Agent的正则表达式，覆盖更多设备类型；
• 不要直接使用完整的User Agent作为缓存键，否则会导致缓存条目数量爆炸，影响Varnish性能；
• 确保你的设备检测逻辑在Magento页面渲染流程的早期执行，避免缓存生成后再修改内容。

内容的提问来源于stack exchange，提问作者S.Venky