任俊慧 发表于 2025-7-4 12:09:18

apisix~fault-injection条件式异常响应


[*]https://apisix.apache.org/zh/docs/apisix/plugins/fault-injection/
[*]https://github.com/apache/apisix/issues/9203
这个插件就是做异常返回的事的,不要使用traffic-split来做这种事


[*]可以根据请求头,查询参数,来动态响应一个异常信息
核心参数


[*]abort.vars 执行故障注入的规则,当规则匹配通过后才会执行故障注。vars 是一个表达式的列表,来自 lua-resty-expr。
注意:


[*]从原码中可以看到,fault-injection插件的优先级非常高,是11000,所以,当你使用这个插件时,如果发现配置未生效,可以修改在使用时重新配置它的优先级即可。
[*]fault-injection插件中的vars条件可能依赖于其它插件处理的结果,所以需要降低fault-injection的优先级。
实例如下


[*]请求参数中name为jack的,直接返回403
[*]请求头中,age为18的,直接返回403
"fault-injection": {
   "_meta": {
      "disable": false,
      "priority": 1
      },
    "abort": {
      "http_status": 403,
      "body": "Fault Injection!\n",
      "vars": [
            [
                [ "arg_name","==","jack" ]
            ]
      ]
    },
    "delay": {
      "duration": 2,
      "vars": [
            [
                [ "http_age","==","18" ]
            ]
      ]
    }
}
      lua-resty-expr 语法介绍

lua-resty-expr 是 OpenResty 中的一个库,用于构建复杂的条件表达式,常用于流量路由、访问控制等场景。它提供了一种声明式的 DSL 来描述条件逻辑。
基本语法结构

lua-resty-expr 的基本表达式是一个 Lua 表(table),由操作符和操作数组成:
local expr = require "resty.expr"
local ex = expr.new({
    {op, var, val},
    {op, var, val},
    -- 更多条件...
})操作符 (op)

支持的操作符包括:
<ul>比较操作符:
<ul>"==":等于
"~=":不等于
">":大于
">=":大于等于
"=", "arg_age", 18}},                {{"==", "arg_country", "US"}}            }      },      {            {"in", "arg_role", {"admin", "superuser"}}      }    }})字符串操作

local ex = expr.new({
    {"==", "arg_foo", "bar"},-- GET 参数 foo 等于 "bar"
    {"==", "http_x_api_key", "12345"},-- X-API-Key 头等于 "12345"
})使用表达式

创建表达式对象后,可以这样使用:
local ex = expr.new({
    {"and",
      {{"==", "arg_debug", "true"}},
      {{"==", "http_user_agent", "test_client"}}
    }
})注意事项


[*]表达式在内部会被编译为高效的 Lua 代码
[*]支持短路求值(short-circuit evaluation)
[*]变量名中的 - 会被替换为 _(例如 http_x_forwarded_for)
lua-resty-expr 提供了一种灵活而强大的方式来描述复杂条件逻辑,特别适合在 OpenResty 的上下文中进行流量控制和路由决策。

来源:豆瓜网用户自行投稿发布,如果侵权,请联系站长删除
页: [1]
查看完整版本: apisix~fault-injection条件式异常响应