WireMock扩展配置报错：--extensions选项不被识别

问题 #

部署WireMock时配置BodyTransformer扩展，通过Helm部署后持续报错，无法启用扩展，需求是通过该扩展获取请求体并根据参数生成自定义响应。

报错信息 #

--extensions com.opentable.extension.BodyTransformer is not a recognized option

原Deployment配置片段 #

apiVersion: apps/v1
kind: Deployment

spec:
  revisionHistoryLimit: 0
  progressDeadlineSeconds: {{ default 300 .Values.deployment.progress_deadline_seconds }}
  minReadySeconds: {{ default 10 .Values.deployment.min_ready_seconds }}
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxUnavailable: {{ default 0 .Values.deployment.max_unavailable }}
      maxSurge: {{ default "50%" .Values.deployment.max_surge }}
  selector:
    matchLabels:
      app: {{ .Values.app | quote }}
      country: {{ .Values.country | quote }}
  template:
    metadata:
    {{- include "labels" . | indent 6 }}
    spec:
      {{- include "node_affinity" . | indent 6 }}
      {{- include "node_tolerations" . | indent 6 }}
      initContainers:
        - name: download-extensions
          image: alpine:latest
          command: ["/bin/sh", "-c", "wget -O /var/wiremock/extensions/wiremock-body-transformer-1.1.3.jar https://repo1.maven.org/maven2/com/opentable/wiremock-body-transformer/1.1.3/wiremock-body-transformer-1.1.3.jar"]
          volumeMounts:
            - mountPath: "/var/wiremock/extensions"
              name: extensions-volume
      containers:
      - env:
        {{ include "dynamic" . | indent 10 }}
        image: "wiremock/wiremock:2.35.0"
        args:
          - "--jetty-acceptor-threads=50"
          - "--jetty-accept-queue-size=50"
          - "--container-threads=100"
          -  "--extensions com.opentable.extension.BodyTransformer"
        imagePullPolicy: IfNotPresent
        name: {{ .Values.app }}-{{ .Values.country}}-{{ .Values.environment }}
        ports:
        - containerPort: {{ .Values.deployment.container_port }}
          protocol: TCP
        resources:
          requests:
            cpu: {{ default "128m" .Values.deployment.resources.requests.cpu }}
            memory: {{ default "128M" .Values.deployment.resources.requests.memory }}
          limits:
            cpu: {{ default "256m" .Values.deployment.resources.limits.cpu }}
            memory: {{ default "256M" .Values.deployment.resources.limits.memory }}
        readinessProbe:
          tcpSocket:
            port: {{ default 3000 .Values.deployment.container_port }}
          initialDelaySeconds: 60
          periodSeconds: 60
          successThreshold: 1
          failureThreshold: 10
          timeoutSeconds: 10
        livenessProbe:
          tcpSocket:
            port: {{ default 3000 .Values.deployment.container_port }}
          initialDelaySeconds: 60
          periodSeconds: 60
          successThreshold: 1
          failureThreshold: 10
          timeoutSeconds: 10
        volumeMounts:
        - mountPath: /home/wiremock/mappings
          name: {{ .Values.app }}-{{ .Values.country }}-mappings
        - name: "extensions-volume"
          mountPath: /var/wiremock/extensions
      volumes:
      - name: {{ .Values.app }}-{{ .Values.country }}-mappings
        configMap:
          name: {{ .Values.app }}-{{ .Values.country }}-mappings
      - name: extensions-volume
        emptyDir: {}

修复步骤 #

1. 修正命令行参数格式 #

Kubernetes容器的args数组要求每个命令行参数拆分为独立元素，原配置将--extensions和类名放在同一个字符串中，会被WireMock识别为一个未定义的完整选项。需拆分为两个独立参数：

args:
  - "--jetty-acceptor-threads=50"
  - "--jetty-accept-queue-size=50"
  - "--container-threads=100"
  - "--extensions"
  - "com.opentable.extension.BodyTransformer"

2. 调整扩展文件挂载路径 #

WireMock官方镜像默认从/home/wiremock/extensions目录加载扩展jar包，原配置的下载和挂载路径为/var/wiremock/extensions，需统一路径：

• 修改initContainer的下载路径与volumeMounts：

initContainers:
  - name: download-extensions
    image: alpine:latest
    command: ["/bin/sh", "-c", "wget -O /home/wiremock/extensions/wiremock-body-transformer-1.1.3.jar https://repo1.maven.org/maven2/com/opentable/wiremock-body-transformer/1.1.3/wiremock-body-transformer-1.1.3.jar"]
    volumeMounts:
      - mountPath: "/home/wiremock/extensions"
        name: extensions-volume

• 修改容器的volumeMounts：

volumeMounts:
  - mountPath: /home/wiremock/mappings
    name: {{ .Values.app }}-{{ .Values.country }}-mappings
  - name: "extensions-volume"
    mountPath: /home/wiremock/extensions

3. （可选）确认版本兼容性 #

WireMock 2.35.0与body-transformer 1.1.3版本兼容，若后续仍有问题，可尝试升级扩展版本至与WireMock匹配的最新稳定版。

修复后验证 #

重新通过Helm部署，检查Pod日志确认扩展加载成功，测试接口验证请求体解析和自定义响应生成功能正常。

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