如何在VCL重载时跨VCL文件传递Varnish VMOD实例变量

你遇到的编译错误根因是：Varnish中通过return(vcl(xxx))调用的独立子VCL标签拥有独立命名空间，主VCL定义的VMOD对象、全局变量默认无法在子VCL中直接访问，且VCL切换时触发的std.rollback(req)会清空所有请求头，导致无法通过请求头传递状态。以下是三种可行的解决方案：

方案1：调整VCL结构，用include替代动态VCL跳转（改动最小，无需修改VMOD） #

如果不需要热重载单个子VCL，可以放弃独立VCL标签的写法，把子VCL逻辑封装为可复用的子程序，主VCL直接引入子文件后调用即可，天然共享主VCL的所有全局对象：

调整后master.vcl代码 #

import mymodule;
include "pub.vcl"; // 直接引入子VCL文件

sub vcl_init {
    new myobj = mymodule.myobject();
}

sub vcl_recv {
    if (req.url ~ "^pub/") {
        call pub_handle; // 直接调用子VCL定义的处理逻辑，无需跳转
        return (lookup); // 后续逻辑根据业务需要调整
    }
    // 其他路由跳转逻辑...
}

调整后pub.vcl代码 #

sub pub_handle {
    if (myobj.mymethod()) {
        set req.http.x-bogus = "true";
    }
}

优点：无需修改VMOD代码，VCL逻辑改动极小，不存在状态传递问题
缺点：子VCL修改后需要重载整个主VCL配置，无法单独热重载子VCL

方案2：修改VMOD实现全局单例实例（最灵活，支持热重载子VCL） #

因为VMOD是你自行开发的，可以在VMOD代码层面将对象状态存储在进程级全局内存中，对外暴露获取全局实例的接口，不需要依赖VCL层的实例传递：

1. 在VMOD代码中添加全局静态变量存储实例指针，加锁保证线程安全
2. 新增get_instance()接口，所有VCL调用该接口都能拿到同一个全局实例
3. 初始化逻辑只需要在主VCL的vcl_init执行一次即可

调整后pub.vcl代码 #

import mymodule;

sub vcl_recv {
    if (mymodule.get_instance().mymethod()) {
        set req.http.x-bogus = "true";
    }
}

优点：支持子VCL独立热重载，全局实例状态跨所有VCL共享，你现有的受ACL保护的状态更新逻辑不需要改动
缺点：需要修改VMOD代码，注意做好线程安全控制避免并发读写问题

方案3：用请求唯一标识作为中介存储状态（无需改VMOD，兼容动态VCL跳转） #

如果既要保留现有动态VCL跳转逻辑，又不想修改VMOD，可以用请求XID作为唯一键，跳转前把需要的计算结果存在VMOD的全局存储中，子VCL中通过XID读取结果：

调整后master.vcl代码 #

sub vcl_recv {
    # 跳转前提前计算需要的结果，存在VMOD的全局KV中，键为当前请求的唯一XID
    myobj.set_temp_val(req.xid, myobj.mymethod());
    if (req.url ~ "^pub/") {
        return (vcl(pub_vcl));
    }
}

调整后pub.vcl代码 #

import mymodule;

sub vcl_recv {
    if (mymodule.get_instance().get_temp_val(req.xid)) {
        set req.http.x-bogus = "true";
    }
    # 用完删除临时值避免内存泄漏
    mymodule.get_instance().del_temp_val(req.xid);
}

优点：兼容现有动态VCL跳转逻辑，无需调整VCL整体结构
缺点：需要VMOD支持临时KV存储能力，多一层读写开销

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