在 pact jvm 中,当 api 响应中某个字段可能为 `null` 或一个非空数组(如 `contents: null` 或 `contents: […]`)时,无法通过单个 `pactdsljsonbody` 表达“或”逻辑;正确做法是为两种值态分别定义独立的交互契约测试用例。
Pact 的核心设计哲学强调契约的确定性与可验证性——它不支持运行时模糊匹配(如 or(null, eachLike(…))),因为这会削弱契约对提供方行为的精确约束力。尽管 PactDslJsonBody.or() 方法存在,但它仅用于并列的、结构完全一致的可选值类型(例如 stringType(“status”) 或 integerType(“status”)),不适用于混合类型场景(如 null vs. array of objects),且 Pact V3 规范本身禁止在单个交互中对同一路径声明歧义性匹配。
因此,针对 contents 字段可能为 null 或非空数组的场景,必须采用双契约模式:为同一请求路径(如 GET /item?name=item-1)注册两个独立的 Interaction,分别描述两种合法响应形态: