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/87372.html" class="text-dark fw-bold text-hover-primary fs-6">PHP新手之PHP入门</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7">PHP是一种易于学习和使用的服务器端脚本语言。只需要很少的编程知识你就能使用PHP建立一个真正交互的...</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/201127.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('/static/assets/images/nopic.gif')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/39209.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/202408/99fac255846c390.jpg')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/110958.html" class="text-dark fw-bold text-hover-primary fs-6">粉嫩如何诠释霸道 东芝M805...</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7">“霸道粉”是个什么玩意东芝M805拿过来的时候,笔者扑哧笑了,不是笑这款笔记本,而是笑这款产品的颜色...</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/163521.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('/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/45708.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('/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('https://files.pic99.top/shayuweb/202501/a2b12b6f1823.png')"></div>
                    </div>
                    <!--end::Symbol-->
                    <!--begin::Title-->
                    <div class="m-0">
                        <a href="/chengxu/185035.html" class="text-dark fw-bold text-hover-primary fs-6">30分钟搞定iOS自定义相机</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7">最近公司的项目中用到了相机,由于不用系统的相机,UI给的相机切图,必须自定义才可以。就花时间简单研究...</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/6024.html" class="text-dark fw-bold text-hover-primary fs-6">Intel将Moblin社区控...</a>
                        <span class="text-gray-600 fw-semibold d-block pt-1 fs-7">本周二,非营利机构Linux基金会宣布,他们将担负起Moblin社区的管理工作,而这之前,Mobli...</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">2026 ©</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://ypkjmy.com.shayuweb.com/">一品科技</a><a href="http://www.yuansudz.com/news/">元素网</a><a href="http://code.shayuweb.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>