配置HTTP重写策略

通过配置HTTP重写策略,您可以在将请求转发给目标后端服务之前修改请求的路径和主机域,以满足特定的业务环境和架构要求。重写策略能够精确地控制请求的路径和主机域,并确保将请求正确地路由到适当的服务或端点。

配置HTTP重写策略

HTTP重写主要用于修改原始请求的路径(Path)和主机域(Host)。

  1. 云原生API网关提供了实例内和实例外两种配置HTTP重写策略的方式:

    实例外API

    1. 登录云原生API网关控制台。左侧导航栏选择API,并在顶部菜单栏选择地域。

    2. 单击目标API,您可以在下拉框中选择需要配置HTTP重写策略的实例,或者选择全部实例image

    3. 选择路由列表中的目标路由。

    实例内API

    1. 登录云原生API网关控制台。左侧导航栏选择实例,并在顶部菜单栏选择地域。

    2. 实例页面,单击目标网关实例ID。左侧导航栏选择API,单击目标API。

    3. 选择路由列表中的目标路由。

  2. 单击策略配置页签,然后单击入站处理启动策略/插件

  3. 单击HTTP重写卡片,在添加策略: HTTP重写面板配置相关参数,然后单击添加

路径(Path)重写

对于路径(Path)重写,云原生API网关支持2种重写模式:精确重写和正则重写。

前缀重写

前缀重写可以修改原始请求的Path前缀。

示例一

原始请求的Path/app/test,但转发给后端服务的Path/test,配置方式建议如下:

  • 路由匹配条件:匹配方式为前缀匹配,Path/app/

  • 重写:重写方式为前缀重写,Path/

说明

路由匹配条件的Path必须设置为/app/,因为前缀重写只会修改前缀匹配字符串。如果路由匹配条件的Path设置为/app,那么经重写后的Path结果将会是//test,不符合预期。

示例二

原始请求的Path/v1/test,但转发给后端服务的Path/v2/test。配置方式建议如下:

  • 路由匹配条件:匹配方式为前缀匹配,Path/v1

  • 重写:重写方式为前缀重写,Path/v2

重要

前缀重写要求路由的匹配方式为前缀匹配,精确匹配和正则匹配不支持前缀重写。由于路由匹配方式为前缀匹配且可以匹配所有带有指定前缀Path的请求,所以您在配置前缀重写时需要关注是否需要对所有这些请求进行重写,否则建议使用精确重写。

正则重写

正则重写可以部分修改原始请求的Path。正则重写包括两个元素,一个是模式匹配串,用于匹配Path上需要修改的部分;另一个是替换串,用于替换匹配成功的Path部分。关于正则表达式的规范,请参见正则表达式语法

示例一

原始请求的Path/aaa/one/bbb/one/ccc,但转发给后端服务的Path/aaa/two/bbb/two/ccc,配置方式建议如下:

  • 路由匹配条件:匹配方式为精确匹配,Path/aaa/one/bbb/one/ccc

  • 重写:重写方式为正则重写,模式串为one,替换串为two

示例二

原始请求的Path/httpbin/(.*)/(.*),希望去掉前缀/httpbin并且将两个正则表达式部分进行位置交换,配置方式建议如下:

  • 路由匹配条件:匹配方式为正则匹配,Path/httpbin/(.*)/(.*)

  • 重写:重写方式为正则重写,模式串为/httpbin/(.*)/(.*),替换串为/\2/\1,其中\1表示第一个正则匹配到的字符串,\2表示第二个正则匹配到的字符串,对应Nginx中的$1,$2用法。

说明

正则重写属于高阶用法,语法较为复杂且一般用于特殊的场景,建议您选择精确重写。

主机域(Host)重写

对于主机域(Host)重写,云原生API网关支持精确重写。

例如,原始请求的Hosttest.com,但转发给后端服务的Hostdev.com,在重写策略中将重写主机设置为dev.com