Azure APIM：Set Backend与Rewrite URL选型及配置问题

结论 #

Set Backend 和 Rewrite URL 都能实现你的需求，只是配置逻辑不同，以下是两种方式的具体配置方法和注意事项：

一、用Rewrite URL实现 #

直接通过重写规则将原始请求URL转换为目标URL，核心是捕获路径中的{uname}变量，并构造正确的查询参数（注意URL编码）。

以Nginx为例，配置规则如下：

location /users/ {
    rewrite ^/users/([^/]+)$ https://backendurl/api/v2/users?filter=%7B%22username%22:%22$1%22%7D? last;
}

• ([^/]+)：精准捕获路径中的{uname}（匹配除斜杠外的所有字符）
• %7B%22username%22:%22$1%22%7D：是{"username":"{uname}"}的URL编码结果，避免双引号在URL中引发解析错误
• 末尾的?：清除原始请求的查询参数（如果有的话）

二、用Set Backend实现 #

先指定后端地址，再通过参数转换插件来添加或修改查询参数，适合需要结合网关其他功能（如认证、限流）的场景。

以Kong网关为例，配置步骤：

1. 设置Backend URL为 https://backendurl/api/v2/users
2. 添加request-transformer插件，配置查询参数规则：
   • 操作类型：add
   • 参数名：filter
   • 参数值：%7B%22username%22:%22$uri_captures[1]%22%7D
3. 确保路由规则捕获{uname}：路由路径设为 /users/(?<uname>[^/]+)，让$uri_captures[1]能正确获取到用户名变量

常见配置错误点 #

• URL编码遗漏：目标URL中的JSON参数必须转义，直接写{"username":"{uname}"}会导致双引号被解析为URL分隔符，引发参数错误
• 变量捕获失败：路径匹配规则要精准，避免捕获多余字符（比如用.*会匹配到斜杠后的所有内容，可能包含不必要的路径片段）
• 路径冲突：使用Set Backend时，要确保原始请求的路径（/users/{uname}）不会被拼接到后端URL后，需在路由中清除原始路径

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