springdoc openapi 接口转换为JMeter测试计划实践指南
作者：RInk7oBjo
本文介绍了基于Springdoc-openapi自动暴露OpenAPI文档,并通过OpenAPIGenerator生成JMeter测试计划的方法,详细步骤包括启动服务、验证OpenAPI文档可用性、使用OpenAPIGenerator生成JMeter脚本以及安装JMeter,感兴趣的朋友一起看看
1. 实践目标
- 为
demo-api增加springdoc-openapi能力，自动暴露 OpenAPI 文档。 - 基于 OpenAPI Generator，通过 cli 方式快速生成 JMeter 测试计划。
- 将生成出的
.jmx文件作为接口测试起点，再结合 JMeter 进行调试和执行。
2. 实践步骤
第一步：启动 demo-api
先启动应用，确保服务运行在本机 8080 端口。
第二步：验证 OpenAPI 文档
启动 demo-api 后，可访问：
OpenAPI JSON：http://localhost:8080/v3/api-docs
在浏览器访问：
http://localhost:8080/v3/api-docs
如果能正常返回 JSON，说明 OpenAPI 文档已经可用。
第三步：使用客户端工具
安装：https://openapi-generator.tech/docs/installation#jar
我采用的 scoop安装 方式。
执行指令：确认安装成功
使用openapi生成jmeter脚本
PS C:\Users\Carter.li> openapi-generator-cli generate -i http://localhost:8080/v3/api-docs -g jmeter -o D:\data\mydemo
执行结果：
[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 # ############################################################################################
第四步：确认生成结果
jmeter打开；
3. JMeter 安装补充
如果本机尚未安装 JMeter，可按官方方式准备：
- 下载 Apache JMeter 发布包
- 解压到本地目录
- 确保本机已有 Java 8 或更高版本
Windows 启动方式：` bin\jmeter.bat `说明：
- GUI 模式适合创建、录制、调试测试计划
- 正式压测建议使用非 GUI 模式
4. 说明
执行流程图
5. 小结
本方案已经把链路收敛为一套可直接复用的方法：
- 启动
demo-api - 验证
/v3/api-docs - 使用 OpenAPI Generator cli 生成
.jmx - 将生成结果输出到本地目录
- 用 JMeter 打开并继续补充测试逻辑
这条路径的价值在于：
- 不依赖本地安装
openapi-generator-cli.jar - 能快速从接口文档得到测试计划骨架
- 适合作为接口测试和后续压测脚本的起点
到此这篇关于springdoc openapi 接口转换为JMeter测试计划实践指南的文章就介绍到这了,更多相关springdoc openapi 接口转换为JMeter内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！