OData查询URL编码异常：空格被转为+而非标准%20（Pact环境）

问题背景 #

你的OData查询中，空格被自动编码为+而非标准URL编码的%20，这是因为部分HTTP库会混淆application/x-www-form-urlencoded格式（用+表示空格）和标准URL路径/查询参数编码（用%20）。针对@pact-foundation/pact的场景，以下是具体解决方法：

解决方法 #

1. 禁用Pact的自动查询参数编码

在Pact中定义交互时，可通过encodeQueryParams配置项禁用自动编码，手动构造已正确编码的查询参数：

provider.addInteraction({
  state: "entities exist",
  uponReceiving: "GET request with OData filter",
  withRequest: {
    method: "GET",
    path: "/api/your-resource",
    query: {
      $select: "ID",
      $expand: "Apps($select=ID,Type;$filter=Target/any(d:(d%20eq%20'PC')))"
    },
    encodeQueryParams: false // 禁用自动编码，保留手动设置的%20
  },
  willRespondWith: {
    status: 200,
    body: {} // 替换为你的实际响应体
  }
});

2. 自定义OData参数编码函数

如果无法禁用自动编码，可编写自定义函数对参数值进行标准URL编码，将+替换回%20：

function encodeODataValue(value) {
  // 先用标准编码处理，再替换+为%20
  return encodeURIComponent(value).replace(/\+/g, '%20');
}

// 构造参数时使用
const filterContent = encodeODataValue("Target/any(d:(d eq 'PC'))");
const expandParam = `Apps($select=ID,Type;$filter=${filterContent})`;

// 将处理后的参数传入Pact的query配置

3. 升级Pact版本

部分旧版本的Pact在处理OData这类复杂查询参数时存在编码逻辑缺陷，升级到@pact-foundation/pact的最新稳定版本，可能已修复该兼容问题。

4. 直接构造完整查询字符串

绕过Pact的查询参数解析逻辑，直接在path中拼接完整的查询字符串（注意确保路径与查询部分的分隔符正确）：

provider.addInteraction({
  withRequest: {
    method: "GET",
    path: "/api/your-resource?$select=ID&$expand=Apps($select=ID,Type;$filter=Target/any(d:(d%20eq%20'PC')))"
  },
  // 其他交互配置...
});

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