Mule APIKit:Router执行mUnit时布尔queryParam类型转换错误如何解决

问题根因 #

该问题源于APIKit对不同请求路径的处理逻辑差异，无需修改现有RAML API规格：

• 真实HTTP请求从HTTP Listener进入时，所有Query参数原生为字符串类型，APIKit Router会自动根据RAML定义的参数类型做自动转换，将"true"字符串转为boolean类型的true完成路由匹配
• mUnit中通过flowReference直接手动构造HttpRequestAttributes对象调用时，APIKit不会触发自动类型转换逻辑，因此出现双向报错：
  • 传boolean类型isAllow: true：APIKit前置参数解析逻辑默认预期Query参数为字符串类型，抛出Boolean转String的类型错误
  • 传字符串类型isAllow: "true"：APIKit Router匹配RAML定义的boolean类型参数时校验不通过，抛出APIKIT:NOT_IMPLEMENTED错误

可行解决方案 #

方案一：使用HTTP Request组件调用本地测试端点（推荐） #

放弃用flowReference直接调用主API流，改为贴合真实运行场景发起本地HTTP请求：

• mUnit运行时会自动启动API对应的HTTP Listener端口
• 直接发送GET请求到http://localhost:8091/api/retrieveInformation?key=12345678&isAllow=true
• 该请求路径和生产环境完全一致，APIKit会自动完成参数类型转换，无适配成本

方案二：手动适配flowReference调用逻辑（适合必须用flowReference的场景） #

如果必须用flowReference直接调用流，可按以下步骤适配：

1. 构造HttpRequestAttributes时先传字符串类型的isAllow: "true"
2. 在APIKit Router前新增Transform Message组件，添加以下转换配置，触发APIKit的类型转换逻辑：

%dw 2.0
output application/java
---
attributes ++ {
    'apikit:originalQueryParams': attributes.queryParams
}

3. 检查APIKit Router的配置项，确认Parse Query Parameters开关已开启，APIKit会自动将字符串类型的Query参数按照RAML定义转换为对应类型

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