WSO2微集成器text/HTML转JSON配置失效问题咨询

核心原因 #

1. 依赖组件调整
   WSO2微集成器（MI）为实现轻量化，移除了EI中默认包含的部分Synapse Commons模块依赖，org.apache.synapse.commons.json.JsonStreamBuilder和JsonStreamFormatter所在的jar包可能不再默认存在于MI的类路径中，导致配置的类无法被加载。

2. 配置加载逻辑变更
   MI对消息构建器/格式化器的加载优先级与EI不同，内置的text/html类型处理器优先级更高，即使在deployment.toml或axis2.xml中配置了自定义处理器，也会被内置的覆盖。

3. 架构轻量化重构
   MI相较于EI做了架构精简，部分非核心的跨类型转换功能默认不再启用，这类直接复用EI配置的场景不在默认支持范围内。

可行解决办法 #

• 补全依赖包
  检查<MI_HOME>/lib目录下是否存在synapse-commons-*.jar，如果没有，从对应版本的WSO2 EI或Maven仓库获取同版本的jar包放入该目录，重启MI。

• 正确配置并覆盖内置处理器
  在deployment.toml中配置时，确保格式正确，同时通过配置优先级覆盖内置处理器：

# 先禁用内置的text/html构建器和格式化器
[message_builders]
"text/html" = ""

[message_formatters]
"text/html" = ""

# 添加自定义的构建器和格式化器
[[custom_message_builders]]
content_type = "text/html"
class = "org.apache.synapse.commons.json.JsonStreamBuilder"

[[custom_message_formatters]]
content_type = "text/html"
class = "org.apache.synapse.commons.json.JsonStreamFormatter"

• 自定义实现兜底
  如果上述方法无效，按照官方文档自定义消息构建器和格式化器：

1. 继承org.apache.axis2.builder.AbstractMessageBuilder实现JsonStreamBuilder的逻辑，将text/html内容解析为JSON格式的OMElement。
2. 继承org.apache.axis2.format.AbstractMessageFormatter实现JsonStreamFormatter的逻辑，将JSON格式的消息序列化为text/html输出。
3. 编译后将jar包放入<MI_HOME>/lib，再通过deployment.toml配置使用自定义类。

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