如何在Mule应用的URI参数中安全传递含斜杠(/)的值？

问题场景 #

基于Mule 4的RAML和APIkit构建API时，URI参数包含正斜杠（如S/AZ）会被误判为路径分隔符，导致请求路由失败；客户端传%2F编码值会被Mule自动解码回/，双重编码虽能解决但无法修改客户端。

官方支持的解决方案 #

方案1：使用RAML通配符URI参数（推荐） #

RAML支持通配符参数（语法{*parameterName}），该参数会捕获从当前位置到下一个路径分隔符之间的所有内容，包括斜杠，无需客户端修改请求格式。

示例RAML定义

#%RAML 1.0
title: School Student API
version: v1
baseUri: /api/v1

/school/{*schoolCode}/student/{studentId}:
  get:
    description: 根据学校编码和学生ID查询信息
    uriParameters:
      schoolCode:
        type: string
        description: 包含斜杠的学校编码，如S/AZ
      studentId:
        type: string

效果

客户端直接发送原请求https://{{host}}:{{port}}/api/v1/school/S/AZ/student/id时，APIkit会正确将schoolCode参数值识别为S/AZ，不会拆分路径。

方案2：禁用APIkit的URI参数自动解码（适配编码后请求） #

如果客户端只能传%2F编码后的参数值，可通过修改APIkit配置禁用自动解码，再手动解码参数：

1. 在APIkit Router的配置界面，找到uriParametersDecode属性，设置为false（默认是true）。
2. 在Flow中使用Mule的urlDecode()函数手动解码参数值：

%dw 2.0
output application/json
---
{
  schoolCode: urlDecode(attributes.uriParameters.schoolCode),
  studentId: attributes.uriParameters.studentId
}

注意

此方案需要客户端传%2F编码的参数（如S%2FAZ），若无法修改客户端则不适用。

关键注意事项 #

• 使用通配符参数时，需确保参数后续的路径段是固定明确的（如示例中的/student/{studentId}），避免路由匹配冲突。
• 通配符参数是RAML 1.0的标准特性，完全受MuleSoft官方支持，无需依赖额外插件或自定义处理。

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