WireMock配置问题：request.query.state参数始终为空

问题现象 #

配置WireMock时，webhook URL中的{{request.query.state}}始终为空，但替换为{{now}}能正常插入当前日期，说明模板功能本身正常。

代码示例 #

upStreamIDPMock.stubFor(
    get(urlPathEqualTo("/oauth/authorize")).willReturn(status(302))
        .withServeEventListener(
            "webhook", webhook()
                .withMethod(RequestMethod.GET)
                .withUrl("http://localhost:8082/oidc/callback?code=$code&state={{request.query.state}}")
        )
)
userService.stubFor(get("/callback").willReturn(ok()))

请求URL #

/oauth/authorize?scope=openid+profile+email&response_type=code&redirect_uri=http%3A%2F%2Flocalhost%3A8082%2Foidc%2Fcallback&state=UHq4_t4jedo3-gtO2uPqNGemeWf-au9yceyrKVPLN7Y&nonce=FnioULWSy-Hd4mmlC6o15d_BOg49MJlZzi3on7ts_PQ

（注：原请求URL疑似缺少?，已修正；若实际请求确实无?，则查询参数无法被WireMock解析）

返回的Webhook请求 #

http://localhost:8082/oidc/callback?code=QxyTZeVACxRxzcJmRB4xQciCApy2aNQsbyDg5-sIU7w&state=

排查与解决步骤 #

1. 确认请求URL格式正确性 #

检查实际请求URL是否用?分隔路径与查询参数：

• 若请求URL为/oauth/authorizescope=...（无?），WireMock会将scope=...识别为路径的一部分，而非查询参数，导致request.query.state为空；
• 修正请求URL为/oauth/authorize?scope=...即可正常解析state参数。

2. 显式启用Webhook的模板功能 #

部分WireMock版本中，Webhook的模板渲染默认未启用（即便全局模板已开启），需在webhook配置中添加withTemplateEnabled(true)：

webhook()
    .withMethod(RequestMethod.GET)
    .withUrl("http://localhost:8082/oidc/callback?code=$code&state={{request.query.state}}")
    .withTemplateEnabled(true) // 显式开启模板渲染

3. 验证查询参数的可访问性 #

先在stub的响应中直接返回state参数，确认WireMock能正确读取查询参数：

upStreamIDPMock.stubFor(
    get(urlPathEqualTo("/oauth/authorize"))
        .willReturn(status(200).withBody("State value: {{request.query.state}}"))
        .withServeEventListener(...)
)

• 若返回的body中能显示正确的state值，说明问题出在Webhook的配置细节上；
• 若仍为空，说明stub的路径匹配规则或请求URL本身存在问题。

4. 检查WireMock版本兼容性 #

部分旧版本WireMock对Webhook模板的支持存在bug，尝试升级到最新稳定版（如3.x系列），看是否能解决问题。

内容的提问来源于stack exchange，提问作者eszik.k