Docker容器中WireMock自定义Webhook扩展失效问题求助

问题分析 #

当前遇到两个核心问题：

1. 配置-cp参数时WireMock启动失败：Docker镜像自带的启动脚本已配置好核心类路径，手动指定-cp会覆盖原有配置，导致WireMock核心类无法加载。
2. 启动成功但请求返回404 找不到匹配的Stub映射：自定义ResponseDefinitionTransformerV2仅负责修改响应逻辑，本身不会自动创建请求匹配规则，必须搭配对应的Stub Mapping才能触发。

解决方案 #

1. 正确放置扩展Jar包 #

将自定义Jar包my_jarnik.jar和Webhooks扩展Jar包wiremock-webhooks-extension-3.4.0.jar都放入Docker容器的/var/wiremock/extensions目录（镜像默认的扩展加载目录）。

2. 修正启动参数 #

删除-cp配置，直接指定需要加载的扩展类：

WIREMOCK_OPTIONS: "--extensions org.wiremock.webhooks.Webhooks,ru.rubbles.gap.wiremock.webhook.WireMockStub"

WireMock Docker镜像会自动扫描extensions目录下的所有Jar包并加入类路径。

3. 创建匹配请求的Stub Mapping #

在/var/wiremock/mappings目录下新建JSON文件（如test-webhook.json），定义请求匹配规则并绑定自定义Transformer：

{
  "request": {
    "method": "ANY",
    "url": "/api/webhook/test"
  },
  "response": {
    "status": 200,
    "transformers": ["WireMockStub"]
  }
}

注意：transformers数组中的名称必须和自定义类getName()方法返回的WireMockStub完全一致。

可选：全局生效Transformer #

如果希望自定义逻辑对所有请求生效，可在启动参数中添加全局Transformer配置：

WIREMOCK_OPTIONS: "--extensions org.wiremock.webhooks.Webhooks,ru.rubbles.gap.wiremock.webhook.WireMockStub --global-response-transformers WireMockStub"

这种方式无需为每个Stub单独配置transformers字段。

验证 #

重启WireMock容器后，发起请求/api/webhook/test，即可得到自定义响应：{"testField": true }

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