springdoc openapi 接口轉(zhuǎn)換為JMeter測試計劃實踐指南

更新時間：2026年04月14日 09:30:49 作者：RInk7oBjo

本文介紹了基于Springdoc-openapi自動暴露OpenAPI文檔,并通過OpenAPIGenerator生成JMeter測試計劃的方法,詳細步驟包括啟動服務、驗證OpenAPI文檔可用性、使用OpenAPIGenerator生成JMeter腳本以及安裝JMeter,感興趣的朋友一起看看

1. 實踐目標

為 demo-api 增加 springdoc-openapi 能力，自動暴露 OpenAPI 文檔。
基于 OpenAPI Generator，通過 cli 方式快速生成 JMeter 測試計劃。
將生成出的 .jmx 文件作為接口測試起點，再結(jié)合 JMeter 進行調(diào)試和執(zhí)行。

2. 實踐步驟

第一步：啟動 demo-api

先啟動應用，確保服務運行在本機 8080 端口。

第二步：驗證 OpenAPI 文檔

啟動 demo-api 后，可訪問：

OpenAPI JSON：http://localhost:8080/v3/api-docs

在瀏覽器訪問：

http://localhost:8080/v3/api-docs

如果能正常返回 JSON，說明 OpenAPI 文檔已經(jīng)可用。
第三步：使用客戶端工具

安裝：https://openapi-generator.tech/docs/installation#jar
我采用的 scoop安裝方式。

執(zhí)行指令：確認安裝成功

使用openapi生成jmeter腳本

PS C:\Users\Carter.li> openapi-generator-cli generate -i http://localhost:8080/v3/api-docs -g jmeter -o  D:\data\mydemo

執(zhí)行結(jié)果：

[main] INFO  o.o.codegen.DefaultGenerator - Generating with dryRun=false
[main] INFO  o.o.c.ignore.CodegenIgnoreProcessor - No .openapi-generator-ignore file found.
[main] INFO  o.o.codegen.DefaultGenerator - OpenAPI Generator: jmeter (client)
[main] INFO  o.o.codegen.DefaultGenerator - Generator 'jmeter' is considered stable.
[main] WARN  o.o.codegen.utils.ExamplesUtils - No application/json content media type found in response. Response examples can currently only be generated for application/json media type.
[main] INFO  o.o.codegen.TemplateManager - writing file D:\data\mydemo\HelloControllerApi.jmx
[main] INFO  o.o.codegen.TemplateManager - writing file D:\data\mydemo\HelloControllerApi.csv
[main] INFO  o.o.codegen.TemplateManager - writing file D:\data\mydemo\LoginControllerApi.jmx
[main] INFO  o.o.codegen.TemplateManager - writing file D:\data\mydemo\LoginControllerApi.csv
[main] INFO  o.o.codegen.TemplateManager - writing file D:\data\mydemo.openapi-generator-ignore
[main] INFO  o.o.codegen.TemplateManager - writing file D:\data\mydemo.openapi-generator\VERSION
[main] INFO  o.o.codegen.TemplateManager - writing file D:\data\mydemo.openapi-generator\FILES
############################################################################################
# Thanks for using OpenAPI Generator.                                                      #
# We appreciate your support! Please consider donation to help us maintain this project.   #
# https://opencollective.com/openapi_generator/donate                                      #
############################################################################################

第四步：確認生成結(jié)果

jmeter打開；

3. JMeter 安裝補充

如果本機尚未安裝 JMeter，可按官方方式準備：

下載 Apache JMeter 發(fā)布包
解壓到本地目錄
確保本機已有 Java 8 或更高版本

Windows 啟動方式：
` bin\jmeter.bat `說明：

GUI 模式適合創(chuàng)建、錄制、調(diào)試測試計劃
正式壓測建議使用非 GUI 模式

4. 說明

執(zhí)行流程圖

5. 小結(jié)

本方案已經(jīng)把鏈路收斂為一套可直接復用的方法：

啟動 demo-api
驗證 /v3/api-docs
使用 OpenAPI Generator cli 生成 .jmx
將生成結(jié)果輸出到本地目錄
用 JMeter 打開并繼續(xù)補充測試邏輯

這條路徑的價值在于：

不依賴本地安裝 openapi-generator-cli.jar
能快速從接口文檔得到測試計劃骨架
適合作為接口測試和后續(xù)壓測腳本的起點

到此這篇關(guān)于springdoc openapi 接口轉(zhuǎn)換為JMeter測試計劃實踐指南的文章就介紹到這了,更多相關(guān)springdoc openapi 接口轉(zhuǎn)換為JMeter內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: