迁移WhatsApp Webhook到WCF：含点GET请求参数绑定难题

问题背景 #

需要在WCF服务中适配WhatsApp Webhook的初始握手GET请求，请求格式固定为：

GET https://www.your-clever-domain-name.com/webhooks?
  hub.mode=subscribe&
  hub.challenge=1158201444&
  hub.verify_token=meatyhamhock

核心需求是将带点的QueryString参数（hub.mode、hub.challenge、hub.verify_token）优雅绑定到WCF方法的参数上，替代手动读取QueryParameters的方式。

最优解决方案：通过UriTemplate明确参数映射 #

WCF的WebGet特性支持在UriTemplate中直接定义QueryString参数与方法参数的映射关系，无需手动解析请求参数。

正确的操作契约定义

[OperationContract]
[CLSCompliant(true)]
[WebGet(
    RequestFormat = WebMessageFormat.Json,
    ResponseFormat = WebMessageFormat.Json,
    BodyStyle = WebMessageBodyStyle.WrappedRequest,
    UriTemplate = "/WhatsApp?hub.mode={mode}&hub.challenge={challenge}&hub.verify_token={verify_token}"
)]
string VerifyToken(string mode, string challenge, string verify_token);

对应的实现代码

public string VerifyToken(string mode, string challenge, string verify_token)
{
    // 直接使用自动绑定的参数，无需手动读取QueryParameters
    // 可添加验证逻辑：校验verify_token是否与预设值匹配
    if (verify_token != "your预设的验证令牌")
    {
        return string.Empty; // 验证失败，返回空拒绝握手
    }
    // 验证通过，返回challenge完成握手
    return challenge;
}

错误方案分析 #

1. 初始UriTemplate配置错误
   最初的UriTemplate将参数定义为路径段（/WhatsApp/hub.mode/{mode}/...），但WhatsApp的请求是把参数放在QueryString中而非路径，导致请求无法匹配，返回"Method not allowed"。

2. 未指定UriTemplate的参数绑定问题
   后续去掉UriTemplate配置后，WCF默认按方法参数名匹配QueryString键，但hub.mode与参数名mode不匹配，导致参数无法自动绑定，只能手动读取。

补充说明 #

• 如果需要支持参数可选（部分场景下参数可能缺失），可在UriTemplate中为参数添加?标记，例如：UriTemplate = "/WhatsApp?hub.mode={mode}&hub.challenge={challenge}&hub.verify_token={verify_token}?"
• 确保WCF服务端点使用webHttpBinding并启用webHttp行为，否则WebGet特性无法生效。

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