Wiremock JS响应模板Linux环境下bodyFileName模板解析失败问题咨询

问题根因 #

你遇到的报错核心是Linux环境下WireMock的响应模板转换器未正常生效，程序直接把{{jsonPath request.body '$.cid'}}模板语法当做普通文件名拼接，没有解析表达式生成实际的文件名。

可行解决方案 #

• 排查响应模板扩展是否正确安装
  Mac本地运行的WireMock通常默认携带响应模板扩展，而Linux部署时若使用官方标准版Jar包，默认未集成该扩展。解决方法：将响应模板扩展Jar放入WireMock的extensions目录，启动时添加参数 --extensions org.wiremock.extension.responsetemplating.ResponseTemplateTransformer 启用扩展。
• 检查启动参数是否禁用了响应模板
  确认Linux启动命令中没有--disable-response-templating参数，该参数会直接关闭模板解析功能，导致表达式不被渲染。
• 排查路径大小写问题
  Mac默认文件系统大小写不敏感，Linux文件系统大小写敏感，需确认配置中的data/路径、文件名大小写和__files目录下的实际路径完全一致。

替代方案 #

如果上述配置调整后仍无法生效，可采用以下兼容方案：

1. 直接在body字段渲染内容，避免动态bodyFileName路径解析问题，配置示例：

{
  "request": {
    "method": "POST",
    "urlPathPattern": "/v1/customer"
  },
  "response": {
    "status": 200,
    "headers": {
      "Content-Type": "application/json"
    },
    "body": "{{readJson (concat 'data/customer-' (jsonPath request.body '$.cid') '.json')}}",
    "transformers": ["response-template"]
  }
}

2. 若cid取值范围有限，可直接为每个cid单独编写固定匹配规则，指定固定的bodyFileName，无需使用模板语法，兼容性最高。
3. 改用WireMock JS的可编程Stub能力，直接在JS逻辑中读取请求参数拼接文件路径，示例：

stubFor(post('/v1/customer')
  .willReturn(ok()
    .withHeader('Content-Type', 'application/json')
    .withBodyFile(`data/customer-${JSON.parse(request.body).cid}.json`)
  )
)

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