springdoc openapi 接口轉換為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 文件作為接口測試起點，再結合 JMeter 進行調試和執(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í)行結果：

[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                                      #
############################################################################################

第四步：確認生成結果