Gatling与gRPC集成配置问题及示例需求

算力阿峰

2026-7-10

问题1：执行`sbt compile`时识别非默认路径的.proto文件是否为正常行为？

这不是sbt的正常行为。Akka gRPC插件默认仅扫描src/main/protobuf（主代码目录）和src/test/protobuf（测试代码目录）下的.proto文件。如果你的.proto文件存放在其他路径，插件不会自动识别并编译，需要手动配置源目录路径：

在build.sbt中添加以下配置：

AkkaGrpcPlugin.settings(
  sourceDirectories in Compile in AkkaGrpcPlugin := Seq(file("你的proto文件所在绝对/相对路径"))
)

如果是测试用的.proto文件，将上述代码中的Compile替换为Test即可。配置完成后，sbt会自动读取指定路径下的proto文件，无需手动复制。

问题2：适配VSCode的Akka-gRPC Gatling脚本示例

以下是基于HelloWorld协议的极简Gatling压测脚本，适配VSCode环境（确保已安装Metals等Scala开发插件）：

1. 先定义proto文件

将helloworld.proto放在src/main/protobuf目录下：

syntax = "proto3";

package helloworld;

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply);
}

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}

2. 创建Gatling测试脚本

在src/test/scala/gatling/HelloWorldSimulation.scala中创建脚本：

import io.gatling.core.Predef._
import com.github.phisgr.gatling.grpc.Predef._
import helloworld.Helloworld._
import helloworld.HelloRequest

class HelloWorldSimulation extends Simulation {

  // 配置gRPC连接
  val grpcConf = grpc(
    managedChannelBuilder("localhost", 8080)
      .usePlaintext() // 非加密连接，生产环境建议启用TLS
  )

  // 构造gRPC请求
  val sayHelloRequest = grpc("SayHello")
    .rpc(GreeterGrpc.METHOD_SAY_HELLO)
    .payload(HelloRequest("Gatling_Tester"))

  // 定义测试场景
  val testScenario = scenario("HelloWorld_gRPC_Perf_Test")
    .exec(sayHelloRequest)

  // 设置压测参数
  setUp(
    testScenario.inject(
      constantUsersPerSec(15) during (12 seconds) // 每秒15个用户，持续12秒
    ).protocols(grpcConf)
  )
}

3. 在VSCode中运行脚本

打开终端执行命令：

运行所有Gatling测试：sbt gatling:test
仅运行当前脚本：sbt "gatling:testOnly gatling.HelloWorldSimulation"

问题3：Gatling与gRPC相关文档是否会更新补充？

目前Gatling官方对gRPC的原生支持有限，主要依赖社区第三方库（如你使用的gatling-grpc）。相关文档的更新节奏取决于以下几点：

Gatling官方核心文档的更新优先保障基础功能，gRPC相关内容的补充需要社区反馈和贡献，你可以通过官方GitHub仓库提交需求或PR推动更新；
gatling-grpc作为第三方维护的库，其文档和功能迭代由维护者主导，建议关注该库的版本更新和Issue列表；
Akka gRPC官方文档会持续更新与测试工具集成的内容，可参考Akka官方文档获取最新集成指南。

随着gRPC在性能测试场景的普及，相关文档和工具支持大概率会逐步完善。

内容的提问来源于stack exchange，提问作者TriNguyen