JMeter内置变量大揭秘:含义,用法和实例
创始人
2025-07-01 11:21:00
0

在JMeter中,有一些内置的变量,可以帮助我们在测试过程中存储和使用一些数据。这些内置变量有四种:vars,props,prev和sample。

vars变量

vars变量是JMeterVariables类的一个实例,它是一个Map类型的对象,可以存储String或Object类型的数据。vars变量的作用域是当前线程组,也就是说,只有同一个线程组内的线程才能访问和修改同一个vars变量。如果不同的线程组需要共享数据,就不能使用vars变量。

vars变量的使用方法很简单,我们可以在BeanShell Sampler或JSR223 Sampler中使用以下语法来获取和设置vars变量:

// JSR233  groovy 脚本
//获取vars变量
String value = vars.get("key");
Object obj = vars.getObject("key");

//设置vars变量
vars.put("key", "value");
vars.putObject("key", new Object());

直接使用${key}来引用vars变量的值。

vars变量的一个常见用途是保存上一个请求的响应数据,以便后续请求使用。例如,我们可以在 JSR233PostProcessor中使用以下代码的一些实例:

又比如从 csv 文件中读取数据,并保存到一个list对象中:

然后从其他取样器中使用这个对象:

props变量

props变量是JMeterProperties类的一个实例,它是一个Hashtable类型的对象,也可以存储String或Object类型的数据。props变量的作用域是全局的,也就是说,所有的线程组都可以访问和修改同一个props变量。如果不同的线程组需要共享数据,就可以使用props变量。

props变量的使用方法和vars变量类似,我们可以在BeanShell Sampler或JSR223 Sampler中使用以下语法来获取和设置props变量:

//获取props变量
String value = props.get("key");
Object obj = props.get("key");

//设置props变量
props.put("key", "value");
props.put("key", new Object());

我们也可以在其他元件中使用${__P(key)}来引用props变量的值。

props变量的一个常见用途是保存一些全局配置参数,例如服务器地址,端口号等。例如,我们可以在Test Plan中使用User Defined Variables元件来定义一些props变量:

然后,在其他地方,我们可以使用${__P(server)}来引用服务器地址。

prev变量

prev变量是SampleResult类的一个实例,它是一个对象,可以存储上一个请求(或者说上一个取样器)的结果信息。prev变量的作用域是当前线程组,并且只能在后置处理器(PostProcessor)或断言(Assertion)中使用。

prev变量的使用方法是在BeanShell PostProcessor或JSR223 PostProcessor中使用以下语法来获取prev变量:

SampleResult prev = ctx.getPreviousResult();

然后,我们可以调用prev对象的各种方法来获取结果信息,例如:

prev变量的一个常见用途是对上一个请求的结果进行处理或判断。例如,我们可以在BeanShell Assertion中使用以下代码来判断响应码是否为200:

SampleResult prev = ctx.getPreviousResult();
if (!"200".equals(prev.getResponseCode())) {
    AssertionResult result = new AssertionResult("检查检查状态码");
    result.setFailure(true);
    result.setFailureMessage("响应状态码鬼知道是啥,反正不是 200");
    prev.addAssertionResult(result);
    prev.setSuccessful(false);
}

当前了,你要是直接在jsr233或者beanshell中直接如下那样写,也不会出现错误,也能直接使用。

//jsr233 中的代码
def responseCode = prev.getResponseCode();

sample变量

sample变量是SampleEvent类的一个实例,它是一个对象,可以存储当前请求(或者说当前取样器)的事件信息。sample变量的作用域是当前线程组,能在监听器(Listener)中使用。

sample变量的使用方法是在BeanShell Listener或JSR223 Listener中使用以下语法来获取sample变量:

SampleEvent sample = ctx.getCurrentSampleEvent();

然后,我们可以调用sample对象的各种方法来获取事件信息,例如:

//获取取样器结果
SampleResult result = sample.getResult();
//获取线程名称
String threadName = sample.getThreadName();
//获取线程组名称
String threadGroupName = sample.getThreadGroup();
//获取主机名称
String hostName = sample.getHostname();

sample变量的一个常见用途是对当前请求的事件进行处理或记录。例如,我们可以在BeanShell Listener中使用以下代码来打印事件信息:

SampleEvent sample = ctx.getCurrentSampleEvent();
log.info("Thread name: " + sample.getThreadName());
log.info("Thread group: " + sample.getThreadGroup());
log.info("Host name: " + sample.getHostname());
log.info("Sampler name: " + sample.getResult().getSampleLabel());
log.info("Response time: " + sample.getResult().getTime());
log.info("Response code: " + sample.getResult().getResponseCode());
log.info("Response data: " + new String(sample.getResult().getResponseData()));

内置变量的区别

从上面的介绍可以看出,JMeter内置变量有以下几个区别:

  • vars和props都是Map类型的对象,可以存储和修改数据;prev和sample都是普通对象,只能读取数据。
  • vars和props都可以在任何地方引用;prev只能在后置处理器或断言中引用;sample只能在监听器中引用。
  • vars和props都需要手动设置和获取;prev和sample都由JMeter自动提供。
  • vars只能在当前线程组内共享;props可以跨线程组共享;prev和sample只能在当前线程内访问。
  • vars和props都只能存储String或Object类型;prev和sample都包含多种类型的数据。

内置变量的实际工作场景

来看一些实际工作场景:

场景一:我们需要模拟用户上传文件,并且每个用户都要上传不同的文件。这时候,我们就可以使用JSR223 PreProcessor元件来动态生成一个文件名,并将它保存到props变量中。然后,在上传文件请求中,我们就可以使用${__P(filename)}来引用文件名。

//在JSR223 PreProcessor的代码如下:
import java.util.UUID
//生成一个随机的UUID作为文件名
String filename = UUID.randomUUID().toString() + ".txt"
//将文件名保存到props变量中
props.put("filename", filename)

场景二:我们需要对每个请求的响应时间进行判断,如果超过了预期的时间,就要记录下来。这时候,我们就可以使用JSR223 Assertion元件来获取prev变量,并调用getTime()方法来获取响应时间。然后,我们就可以使用if语句来判断响应时间是否超过了预期,并使用log.info()方法来记录日志。

//在JSR223 Assertion 中的代码如下:
def prev = ctx.getPreviousResult()
//获取响应时间
def responseTime = prev.getTime()
//设置预期时间为1000毫秒
def expectedTime = 1000
//判断响应时间是否超过预期
if (responseTime > expectedTime) {
    // 这里建议将结果写入 csv 以便持久化查看
    log.info("响应时间是:${responseTime} ms, 预期时间是:${expectedTime} ms")
}

场景三:我们需要对每个请求的响应数据进行处理,如果包含了某些关键字,就要提取出来,那么则如下:

//在JSR223 PostProcessor 中的代码如下:
def prev = ctx.getPreviousResult()
def responseData = prev.getResponseDataAsString()
// 使用正则处理数据
def regex = /(.*?)<\/title>/
def matcher = regex.matcher(responseData)
if (matcher.find()) {
    def keyword = matcher.group(1)
    vars.put("keyword", keyword)
}
// 当然除了上述代码外,也可以直接使用正则匹配元件去处理。</code></pre><p>场景四:我们需要对每个请求的事件信息进行记录,例如线程名称,线程组名称,主机名称等,那么则如下:</p><pre class="language-javascript"><code>//在JSR223 Listener 中的代码
def sample = ctx.getCurrentSampleEvent()
def result = sample.getResult()
//打印事件信息到日志文件中,建议处理到csv(不过会有一点性能开销)
log.info("线程名称: " + sample.getThreadName())
log.info("线程组名: " + sample.getThreadGroup())
log.info("域名地址: " + sample.getHostname())
log.info("取样器名: " + result.getSampleLabel())
log.info("响应时间: " + result.getTime())
log.info("响应编码: " + result.getResponseCode())
log.info("响应数据: " + new String(result.getResponseData()))</code></pre>                 <!--end::Text-->
            </div>
            <!--end::Description-->
            <div class="mt-5">
                <!--关键词搜索-->
                            </div>
            <div class="mt-5">
                <p class="fc-show-prev-next">
                    <strong>上一篇:</strong><a href="/chengxu/359405.html">智能恒温器存在网络安全风险吗?</a><br>
                </p>
                <p class="fc-show-prev-next">
                    <strong>下一篇:</strong><a href="/chengxu/359407.html">机器人技术如何预示着建筑业的新时代</a>                </p>
            </div>
            <!--begin::Block-->
            <div class="d-flex flex-stack mb-2 mt-10">
                <!--begin::Title-->
                <h3 class="text-dark fs-5 fw-bold text-gray-800">相关内容</h3>
                <!--end::Title-->
            </div>
            <div class="separator separator-dashed mb-9"></div>
            <!--end::Block-->
            <div class="row g-10">
                
            </div>


        </div>
        <!--end::Table widget 14-->
    </div>
    <!--end::Col-->

    <!--begin::Col-->
    <div class="col-xl-4 mt-0">
        <!--begin::Chart Widget 35-->
        <div class="card card-flush h-md-100">
            <!--begin::Header-->
            <div class="card-header pt-5 ">
                <!--begin::Title-->
                <h3 class="card-title align-items-start flex-column">
                    <!--begin::Statistics-->
                    <div class="d-flex align-items-center mb-2">
                        <!--begin::Currency-->
                        <span class="fs-5 fw-bold text-gray-800 ">热门资讯</span>
                        <!--end::Currency-->
                    </div>
                    <!--end::Statistics-->
                </h3>
                <!--end::Title-->
            </div>
            <!--end::Header-->
            <!--begin::Body-->
            <div class="card-body pt-3">

                                <!--begin::Item-->
                <div class="d-flex flex-stack mb-7">
                    <!--begin::Symbol-->
                    <div class="symbol symbol-60px symbol-2by3 me-4">
                        <div class="symbol-label" style="background-image: url('/static/assets/images/nopic.gif')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/241137.html" class="text-dark fw-bold text-hover-primary fs-6">如何允许远程连接到MySQL数...</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7">[[277004]]【51CTO.com快译】默认情况下,MySQL服务器仅侦听来自localhos...</span>
                    </div>
                    <!--end::Title-->
                </div>
                                <!--begin::Item-->
                <div class="d-flex flex-stack mb-7">
                    <!--begin::Symbol-->
                    <div class="symbol symbol-60px symbol-2by3 me-4">
                        <div class="symbol-label" style="background-image: url('/static/assets/images/nopic.gif')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/61017.html" class="text-dark fw-bold text-hover-primary fs-6">如何利用交换机和端口设置来管理...</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7">在网络管理中,总是有些人让管理员头疼。下面我们就将介绍一下一个网管员利用交换机以及端口设置等来进行D...</span>
                    </div>
                    <!--end::Title-->
                </div>
                                <!--begin::Item-->
                <div class="d-flex flex-stack mb-7">
                    <!--begin::Symbol-->
                    <div class="symbol symbol-60px symbol-2by3 me-4">
                        <div class="symbol-label" style="background-image: url('/static/assets/images/nopic.gif')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/119031.html" class="text-dark fw-bold text-hover-primary fs-6">施耐德电气数据中心整体解决方案...</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7">近日,全球能效管理专家施耐德电气正式启动大型体验活动“能效中国行——2012卡车巡展”,作为该活动的...</span>
                    </div>
                    <!--end::Title-->
                </div>
                                <!--begin::Item-->
                <div class="d-flex flex-stack mb-7">
                    <!--begin::Symbol-->
                    <div class="symbol symbol-60px symbol-2by3 me-4">
                        <div class="symbol-label" style="background-image: url('https://files.pic99.top/shayuweb/202407/da6c51fc268b.jpg')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/82595.html" class="text-dark fw-bold text-hover-primary fs-6">Windows恶意软件20年“...</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7">在Windows的早期年代,病毒游走于系统之间,偶尔删除文件(但被删除的文件几乎都是可恢复的),并弹...</span>
                    </div>
                    <!--end::Title-->
                </div>
                                <!--begin::Item-->
                <div class="d-flex flex-stack mb-7">
                    <!--begin::Symbol-->
                    <div class="symbol symbol-60px symbol-2by3 me-4">
                        <div class="symbol-label" style="background-image: url('https://files.pic99.top/shayuweb/202409/eb2e03366045d9f.jpg')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/139440.html" class="text-dark fw-bold text-hover-primary fs-6">20个非常棒的扁平设计免费资源</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7">Apple设备的平面图标PSD免费平板UI 平板UI套件24平图标Freen平板UI套件PSD径向平...</span>
                    </div>
                    <!--end::Title-->
                </div>
                                <!--begin::Item-->
                <div class="d-flex flex-stack mb-7">
                    <!--begin::Symbol-->
                    <div class="symbol symbol-60px symbol-2by3 me-4">
                        <div class="symbol-label" style="background-image: url('/static/assets/images/nopic.gif')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/27164.html" class="text-dark fw-bold text-hover-primary fs-6">2009 IBM动态架构新动力...</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7"></span>
                    </div>
                    <!--end::Title-->
                </div>
                                <!--begin::Item-->
                <div class="d-flex flex-stack mb-7">
                    <!--begin::Symbol-->
                    <div class="symbol symbol-60px symbol-2by3 me-4">
                        <div class="symbol-label" style="background-image: url('/static/assets/images/nopic.gif')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/225.html" class="text-dark fw-bold text-hover-primary fs-6">通过 XML 进行内容发布</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7"></span>
                    </div>
                    <!--end::Title-->
                </div>
                                <!--begin::Item-->
                <div class="d-flex flex-stack mb-7">
                    <!--begin::Symbol-->
                    <div class="symbol symbol-60px symbol-2by3 me-4">
                        <div class="symbol-label" style="background-image: url('/static/assets/images/nopic.gif')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/130901.html" class="text-dark fw-bold text-hover-primary fs-6">德国电信门户网站可实时显示全球...</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7">德国电信周三推出一个门户网站,直观地实时提供其安装在全球各地的传感器网络检测到的网络攻击状况。该网站...</span>
                    </div>
                    <!--end::Title-->
                </div>
                                <!--begin::Item-->
                <div class="d-flex flex-stack mb-7">
                    <!--begin::Symbol-->
                    <div class="symbol symbol-60px symbol-2by3 me-4">
                        <div class="symbol-label" style="background-image: url('https://files.pic99.top/shayuweb/202403/3888b00968de30e.jpg')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/884.html" class="text-dark fw-bold text-hover-primary fs-6">着眼MAC地址,解救无法享受D...</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7">在安装了DHCP服务器的局域网环境中,每一台工作站在上网之前,都要先从DHCP服务器那里享受到地址动...</span>
                    </div>
                    <!--end::Title-->
                </div>
                                <!--begin::Item-->
                <div class="d-flex flex-stack mb-7">
                    <!--begin::Symbol-->
                    <div class="symbol symbol-60px symbol-2by3 me-4">
                        <div class="symbol-label" style="background-image: url('https://files.pic99.top/shayuweb/202503/5fe82cca6c5ff78.jpg')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/246646.html" class="text-dark fw-bold text-hover-primary fs-6">为啥国人偏爱 Mybatis,...</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7">关于 SQL 和 ORM  的争论,永远都不会终止,我也一直在思考这个问题。昨天又跟群里的小伙伴进行...</span>
                    </div>
                    <!--end::Title-->
                </div>
                
            </div>
            <!--end::Body-->
        </div>
        <!--end::Chart Widget 35-->
    </div>
    <!--end::Col-->
</div>



</div>
<!--end::Content container-->
</div>
<!--end::Content-->
</div>
<!--end::Content wrapper-->
<!--begin::Footer-->
<div id="kt_app_footer" class="app-footer">
    <!--begin::Footer container-->
    <div class="app-container container-xxl d-flex flex-column flex-md-row flex-center flex-md-stack py-3">
        <!--begin::Copyright-->
        <div class="text-dark order-2 order-md-1">
            <span class="text-muted fw-semibold me-1">2025 ©</span>
            <a href="/" target="_blank" class="text-gray-800 text-hover-primary">鲨鱼网</a>
            <a href="https://beian.miit.gov.cn/" target="_blank" class="text-gray-800 text-hover-primary"></a>
            <a href="http://spbjmm.com.shayuweb.com">上品网</a><a href="http://www.zzszq.net/">深知网</a><a href="http://www.taiyangwa.net/">太阳生活网</a><a href="http://baike.taiyangwa.net/">太阳百科网</a><a href="http://ypkjmy.com.shayuweb.com/">一品科技</a><a href="http://www.yuansudz.com/news/">元素网</a><a href="http://www.xn--i6qw12a.com/">帛典网</a><a href="http://xldmm.com.shayuweb.com/">星链岛</a>        </div>
        <!--end::Copyright-->
        <!--begin::Menu-->
        <ul class="menu menu-gray-600 menu-hover-primary fw-semibold order-1">
                        <li class="menu-item">
                <a href="/news/" target="_blank" class="menu-link px-2">科技资讯</a>
            </li>
                        <li class="menu-item">
                <a href="/chengxu/" target="_blank" class="menu-link px-2">程序开发</a>
            </li>
                        <li class="menu-item">
                <a href="/sitemap.xml" target="_blank" class="menu-link px-2">sitemap</a>
            </li>
        </ul>
        <!--end::Menu-->
    </div>
    <!--end::Footer container-->
</div>
<!--end::Footer-->
</div>
<!--end:::Main-->
</div>
<!--end::Wrapper-->
</div>
<!--end::Page-->
</div>
<!--end::App-->
<div id="kt_scrolltop" class="scrolltop" data-kt-scrolltop="true">
    <!--begin::Svg Icon | path: icons/duotune/arrows/arr066.svg-->
    <span class="svg-icon">
        <svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
            <rect opacity="0.5" x="13" y="6" width="13" height="2" rx="1" transform="rotate(90 13 6)" fill="currentColor"></rect>
            <path d="M12.5657 8.56569L16.75 12.75C17.1642 13.1642 17.8358 13.1642 18.25 12.75C18.6642 12.3358 18.6642 11.6642 18.25 11.25L12.7071 5.70711C12.3166 5.31658 11.6834 5.31658 11.2929 5.70711L5.75 11.25C5.33579 11.6642 5.33579 12.3358 5.75 12.75C6.16421 13.1642 6.83579 13.1642 7.25 12.75L11.4343 8.56569C11.7467 8.25327 12.2533 8.25327 12.5657 8.56569Z" fill="currentColor"></path>
        </svg>
    </span>
    <!--end::Svg Icon-->
</div>
<!--begin::Javascript-->
<script>var hostUrl = "/static/default/pc/";</script>
<!--begin::Global Javascript Bundle(mandatory for all pages)-->
<script src="/static/default/pc/plugins/global/plugins.bundle.js"></script>
<script src="/static/default/pc/js/scripts.bundle.js"></script>
<!--end::Global Javascript Bundle-->

<!--end::Javascript-->
</body>
<!--end::Body-->
</html>