使用wiremock-grpc-extension模拟gRPC服务器遇“方法未找到”错误求助

以下是针对性的排查步骤和修复建议：

1. 核对 gRPC 方法全限定路径 #

gRPC 方法的调用路径格式为 /包名.服务名/方法名，比如你的 SayHello 方法如果定义在 helloworld.proto 中：

package helloworld;

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

对应的正确路径应为 /helloworld.Greeter/SayHello。

检查你的 WireMock Stub 配置：

• 必须通过全限定路径匹配，不能只写 SayHello
• 示例正确配置：

  stubFor(grpc("/helloworld.Greeter/SayHello")
      .willReturn(grpcResponse(HelloReply.newBuilder().setMessage("Mocked Hello").build())));
  

2. 验证 Proto 文件加载与代码生成 #

• 确认 WireMock 初始化时加载了原始 proto 文件，而非仅依赖生成的 Java 代码：

  GrpcMappings.loadFromProtoFile(wireMockServer, new File("src/main/proto/helloworld.proto"));
  

• 检查生成的 gRPC 客户端代码（如 GreeterGrpc 类），调用 SAY_HELLO_METHOD.getFullMethodName()，确认返回的路径和你 Stub 中配置的完全一致。

3. 确认 gRPC 端口配置 #

WireMock gRPC 扩展的默认端口与 HTTP 端口分离，需注意：

• 初始化时明确指定 gRPC 端口：

  wireMockServer = new WireMockServer(options()
      .port(8080) // HTTP 端口
      .grpcPort(9090) // gRPC 专属端口
      .extensions(new GrpcExtension()));
  

• Postman 调用 gRPC 时，必须连接上述 grpcPort 指定的端口，而非 HTTP 端口。

4. 简化 Stub 规则排查匹配问题 #

暂时去掉所有请求体匹配条件，先配置一个最基础的 Stub 测试：

stubFor(grpc("/helloworld.Greeter/SayHello")
    .willReturn(grpcResponse(HelloReply.newBuilder().setMessage("Basic Mock").build())));

如果此时能正常响应，说明之前的 Stub 添加了过严的匹配规则导致请求不命中。

5. 查看 WireMock 详细请求日志 #

开启 WireMock 调试日志，查看收到的 gRPC 请求的实际路径和参数：

• 日志中会显示请求的完整方法路径，对比你 Stub 中的配置是否一致
• 如果路径不匹配，直接修正 Stub 中的路径即可

6. 检查依赖版本兼容性 #

确保 wiremock-grpc-extension、WireMock 核心包、gRPC 核心包的版本兼容：

• 比如 wiremock-grpc-extension:3.x 对应 WireMock 3.x 版本，2.x 对应 WireMock 2.x 版本
• 版本不匹配可能导致 gRPC 协议解析异常

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