APIM中移除URL查询参数报错及参数未生效问题求助

问题根源分析 #

1. 500错误原因：你使用的<rewrite-uri template="_/_?Page={Page}" />硬编码了Page参数，若请求未携带该参数，APIM会因模板参数缺失触发内部错误。
2. 参数未彻底移除：当前<set-query-parameter>用了override动作并赋值，这不是移除参数的正确方式；再加上rewrite-uri的写法导致查询参数处理逻辑冲突，最终ax-ky参数又被保留下来。

正确策略实现 #

要移除ax-ky并保留所有其他查询参数，按以下方式调整策略：

1. 移除指定查询参数 #

使用exists-action="delete"直接删除ax-ky，无需设置value：

<set-query-parameter name="ax-ky" exists-action="delete" />

2. 重写路径（若需要） #

如果必须将路径重写为_/_，同时保留所有剩余查询参数，不要在rewrite-uri模板里硬编码参数，改用copy-unmatched-params="true"自动保留其他参数：

<rewrite-uri template="_/_" copy-unmatched-params="true" />

完整入站策略代码 #

<inbound>
    <!-- 移除ax-ky查询参数 -->
    <set-query-parameter name="ax-ky" exists-action="delete" />
    <!-- 重写路径并保留所有其他查询参数 -->
    <rewrite-uri template="_/_" copy-unmatched-params="true" />
    <!-- 其他入站策略 -->
</inbound>

验证说明 #

• 部署后，APIM会先删除ax-ky参数，再重写路径并自动保留所有剩余查询参数（包括Page）。
• 即使请求中没有Page参数，也不会触发500错误，因为不再依赖硬编码的模板参数。

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