WSO2 API Manager上下文路径参数使用及中介流调用方法咨询

首先得明确：WSO2 APIM 默认不支持在<context>节点中直接使用{parameter}这种路径参数语法——因为<context>被设计为API的固定基础路径，不像<resource>是具体资源的可变路径段。不过我们可以通过几种变通方案实现类似需求，让你能在中介流中获取原本想放在context里的动态值：

方案1：将参数移至Resource路径，直接提取 #

这是最简洁的官方推荐方式。把原本想放在context的参数放到resource路径的最前端，然后直接用uri.var.parameter在中介流中调用。

举个例子：

• 把API的<context>设为固定值：/my-api
• 定义Resource路径为：/{tenantId}/users（把原本的context参数移到resource开头）

此时在中介流中，你可以直接通过get-property('uri.var.tenantId')获取这个参数，和你在resource中使用参数的方式完全一致。这种方式不会破坏API的统计、监控等原生功能，是最稳妥的选择。

方案2：通过入站中介流提取并重写上下文 #

如果业务场景要求参数必须出现在context位置（比如外部客户端的请求格式固定），可以通过入站中介流手动提取参数、重写请求上下文，再将参数存入uri.var供后续使用。

示例中介流代码： #

<sequence xmlns="http://ws.apache.org/ns/synapse" name="extract-context-param-sequence">
    <!-- 1. 获取完整的请求路径后缀 -->
    <property name="fullRequestPath" expression="$axis2:REST_URL_POSTFIX"/>
    
    <!-- 2. 用正则表达式提取context中的目标参数（假设请求路径为 /api/{tenantId}/v1/orders） -->
    <property name="extractedTenantId" expression="fn:replace($ctx:fullRequestPath, '^/api/([^/]+)/.*', '$1')"/>
    
    <!-- 3. 重写请求上下文，移除参数部分，让网关能匹配到API的固定context -->
    <rewrite>
        <rewriteUri template="/api/v1/orders"/>
    </rewrite>
    
    <!-- 4. 将参数存入uri.var，方便后续中介流调用 -->
    <property name="uri.var.tenantId" expression="$ctx:extractedTenantId"/>
</sequence>

配置步骤： #

1. 在API Publisher中，将API的<context>设为重写后的固定路径（比如/api）
2. 在API的"Inbound Mediation"中添加上述自定义序列
3. 确保Resource路径和重写后的路径匹配（比如/v1/orders）

注意事项： #

• 这种方式会修改请求的原始路径，可能影响API的访问日志、统计数据（比如路径统计会显示重写后的路径）
• 正则表达式需要根据你的实际路径格式调整，避免匹配错误

方案3：使用动态端点/条件路由结合参数提取 #

如果你的需求是根据context中的参数路由到不同后端，可以结合上述参数提取方式，搭配WSO2的动态端点功能：

1. 先用方案2的中介流提取context中的参数（比如tenantId）
2. 在API的端点配置中选择"Dynamic Endpoint"，使用表达式引用提取的参数：

   <endpoint xmlns="http://ws.apache.org/ns/synapse" name="dynamic-tenant-endpoint">
       <http uri-template="http://backend-{uri.var.tenantId}.example.com/api/orders"/>
   </endpoint>
   

这样就能根据context中的参数动态路由到对应的后端服务。

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