APIKit前设置属性时遇ByteArrayBasedCursorStreamProvider转HttpRequestAttributes错误

问题背景 #

需要在APIKit Router执行前，满足特定条件时修改HttpRequestAttributes属性（用于日志记录），原Transform组件脚本如下：

output application/json
---
(
    (attributes 
        - "headers"
        - "maskedRequestPath")
    ++
    ({ 
        headers: attributes.headers 
        ++ 
        { 
            xpto: 123
        }
    }) 
)
as Object {
    class: "org.mule.extension.http.api.HttpRequestAttributes"
}

执行后出现类型转换错误：

org.mule.weave.v2.el.ByteArrayBasedCursorStreamProvider cannot be cast to org.mule.extension.http.api.HttpRequestAttributes

环境：APIKit v1.6.1，Mule 4.3.0运行时。

解决方案 #

核心问题原因 #

原脚本指定了output application/json，导致Weave将处理后的对象序列化为JSON字节流（ByteArrayBasedCursorStreamProvider类型），而非保留HttpRequestAttributes对象，后续类型转换自然失败。

正确实现方式 #

方式1：使用Runtime::newInstance构造新实例

通过直接调用Java类的构造方法创建新的HttpRequestAttributes实例，保留原属性的同时修改headers：

import * from dw::Runtime
---
Runtime::newInstance(
    "org.mule.extension.http.api.HttpRequestAttributes",
    [
        attributes.getMethod(),
        attributes.getRequestUri(),
        attributes.getPath(),
        attributes.getQueryParams(),
        attributes.getHeaders() ++ { xpto: "123" }, // 添加自定义header，注意值类型与原headers匹配
        attributes.getCookies(),
        attributes.getPayload(),
        attributes.getRemoteAddress(),
        attributes.getLocalAddress(),
        attributes.getProtocol(),
        attributes.getRequestLine(),
        attributes.getMaskedRequestPath()
    ]
)

注意：构造方法的参数顺序必须与HttpRequestAttributes类的构造方法签名完全一致，参数值类型需匹配。

方式2：使用update操作符（简化写法）

如果原attributes本身就是HttpRequestAttributes类型，可直接用update操作符修改headers，必须去掉output声明：

---
attributes update {
    case headers -> headers ++ { xpto: "123" }
} as Object { class: "org.mule.extension.http.api.HttpRequestAttributes" }

关键注意事项 #

• 必须移除Transform组件脚本中的output application/json，确保返回的是Java对象而非序列化后的字节流。
• 修改headers时，新键值对的类型需与原headers中的值类型一致（比如原headers值多为字符串，避免使用数字类型导致不兼容）。

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