WSO2使用Data Service Call中介器报错：Unknown mediator引用错误

问题描述 #

在WSO2代理服务中使用dataServiceCall中介时，触发报错：Unknown mediator referenced by configuration element: dataServiceCall。用户编写的代理服务代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<proxy name="TestData" startOnLoad="true" transports="http https local" xmlns="http://ws.apache.org/ns/synapse">
    <target>
        <inSequence>
            <dataServiceCall serviceName="Hello">
            </dataServiceCall>
            <respond/>
        </inSequence>
        <outSequence/>
        <faultSequence/>
    </target>
</proxy>

报错原因 #

dataServiceCall属于Data Service（DSS）中介，并非WSO2 API Manager（APIM）默认内置组件，必须单独部署对应的Data Services特性包后才能使用，未部署时服务器无法识别该中介元素。

解决步骤 #

1. 版本兼容性检查
   确认你的WSO2 APIM版本与Data Services组件的兼容性：

   • APIM 3.2.0及后续版本：Data Services功能整合为官方特性包，需匹配对应版本的特性包；
   • 旧版APIM：需下载对应版本的DSS集成插件。

2. 安装Data Services特性包

   • 方式一：使用WSO2 Update Manager（WUM）更新产品，自动安装适配的Data Services特性；
   • 方式二：手动下载对应版本的Data Services Server特性包，将其放置到{APIM安装目录}/repository/components/dropins目录下，重启APIM服务器。

3. 验证配置与服务状态

   • 重启服务器后，重新部署代理服务，检查报错是否消失；
   • 确认serviceName="Hello"指定的Data Service已正确部署，且在APIM控制台中处于运行状态。

4. 命名空间检查（可选）
   部分版本中需显式添加Data Services命名空间，修改代理服务xml的根标签：

   <proxy name="TestData" startOnLoad="true" transports="http https local" 
          xmlns="http://ws.apache.org/ns/synapse" 
          xmlns:dss="http://ws.apache.org/ns/synapse/dss">
   

   同时将dataServiceCall标签改为<dss:dataServiceCall>。

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