152-java-performance-gatling

基于 Gatling 运行性能测试

为 Java Maven 项目提供完整的 Gatling 性能测试配置：添加所需的测试依赖和 Gatling Maven 插件配置，创建或说明 Java 仿真脚本的存放位置，并介绍如何运行仿真和查看报告。

此 Skill 涵盖哪些内容？

• 将 Gatling 依赖和 gatling-maven-plugin 添加到 pom.xml
• 项目结构：Java 仿真脚本放在 src/test/java，Gatling 配置、馈送器、模板和日志配置放在 src/test/resources
• 使用 ./mvnw gatling:test 运行仿真
• 存在多个仿真时，使用 -Dgatling.simulationClass=<FullyQualifiedClassName> 选择仿真
• 使用 ./mvnw gatling:help -Ddetail=true -Dgoal=test 查看可用的插件选项
• 查看构建输出目录下生成的 Gatling 运行输出和报告

**范围：**通过 Maven 插件运行 Gatling Java 仿真。若项目中有 Maven Wrapper，优先使用项目本地的 Maven Wrapper 命令。

约束

Gatling 配置必须基于 Maven、可复现，并符合 Java 项目惯例。优先遵循 Gatling Maven 插件的官方行为，避免编造不受支持的命令行选项。

• 前置条件：确认项目基于 Maven，并在存在 Maven Wrapper 时优先使用 ./mvnw
• 构建配置：添加作用域为 test 的 Gatling 依赖，并在 pom.xml 中配置 io.gatling:gatling-maven-plugin
• 版本选择：遵循项目现有的依赖和版本管理方式；如果尚未配置 Gatling 版本，请在固定版本前询问，或使用需要替换的占位符
• 仿真脚本位置：将 Java 仿真脚本放在 src/test/java 下，并使用合适的包名
• 资源位置：将 gatling.conf、馈送器、请求正文模板和 Logback 测试配置等 Gatling 资源放在 src/test/resources 下
• 应用前：阅读参考资料，了解配置、执行和验证指南
• 边缘情况：如果项目不是基于 Maven，请停止操作，并说明此 Skill 面向 Maven 项目，然后再建议 Gradle 或 sbt 等替代方案
• 边缘情况：如果存在多个仿真，为非交互式执行配置或传入 -Dgatling.simulationClass=<FullyQualifiedClassName>

何时使用此 Skill

• 添加 Gatling 性能测试
• 使用 Gatling 性能测试
• 创建 Gatling 仿真
• 添加 Gatling 支持
• 检查 Gatling 性能测试断言和馈送器

工作流

1. 检查 Maven 项目

检查是否存在 pom.xml 和 Maven Wrapper，并查看现有测试依赖、依赖管理、插件管理以及任何现有的 Gatling 配置。

2. 添加 Gatling 构建配置

按照项目现有的版本和插件配置风格，添加 Gatling 测试依赖和 io.gatling:gatling-maven-plugin。

3. 创建或调整 Java 仿真脚本

在 src/test/java 下创建 Java 仿真类，或调整现有仿真；明确设置场景名称、基础 URL、注入配置和断言。

4. 配置资源

按需在 src/test/resources 下添加 Gatling 资源，包括 gatling.conf、馈送器、请求正文模板，以及仅在项目需要时添加 logback-test.xml。

5. 运行并说明 Gatling 执行方式

使用 ./mvnw gatling:test 运行仿真；需要选择特定仿真时，使用 -Dgatling.simulationClass=<FullyQualifiedClassName>。

6. 验证报告并说明后续步骤

确认 Gatling 运行已完成，根据命令输出指出生成报告的位置，并概述任何失败的断言或性能发现。

参考资料

详细指南、示例和约束请参阅 references/152-java-performance-gatling.md。