examples/request-block/main.go:31-40：

func main() {}   // :31 空的！

func init() {    // :33 真正的入口
    wrapper.SetCtx(
        "request-block",
        wrapper.ParseConfig(parseConfig),
        wrapper.ProcessRequestHeaders(onHttpRequestHeaders),
        wrapper.ProcessRequestBody(onHttpRequestBody),
    )
}

SetCtx("request-block", 选项...) 做了两件事：给插件起名、注册一组"回调函数"。这里注册了三个：

• ParseConfig(parseConfig)：怎么解析配置。
• ProcessRequestHeaders(onHttpRequestHeaders)：请求头到达时干什么。
• ProcessRequestBody(onHttpRequestBody)：请求体到达时干什么。

:42-51 定义这个插件能接受哪些配置：

type RequestBlockConfig struct {
    blockedCode      uint32          // 拦截时返回的状态码
    blockedMessage   string          // 拦截时返回的消息
    caseSensitive    bool            // 是否大小写敏感
    blockUrls        []string        // 命中即拦的 URL 关键词
    blockExactUrls   []string        // 精确匹配的 URL
    blockHeaders     []string        // 命中即拦的请求头
    blockBodies      []string        // 命中即拦的请求体关键词
    blockRegExpArray []*regexp.Regexp // 正则规则
}

:53-124 把 JSON 配置读进结构体（用 gjson 按路径取值）：

func parseConfig(json gjson.Result, config *RequestBlockConfig) error {
    code := json.Get("blocked_code").Int()
    if code != 0 && code > 100 && code < 600 {
        config.blockedCode = uint32(code)
    } else {
        config.blockedCode = 403     // 默认 403
    }
    config.caseSensitive = json.Get("case_sensitive").Bool()
    for _, item := range json.Get("block_urls").Array() {  // 遍历数组
        url := item.String()
        if url == "" { continue }
        config.blockUrls = append(config.blockUrls,
            ternaryLower(url, config.caseSensitive))
    }
    // ... block_exact_urls / block_regexp_urls / block_headers / block_bodies 同理
    if len(config.blockUrls)==0 && len(config.blockHeaders)==0 && len(config.blockBodies)==0 {
        return errors.New("there is no block rules")   // :121 配置校验
    }
    return nil
}

:126-185：请求头到达时，检查 URL/请求头是否命中拦截规则：

func onHttpRequestHeaders(ctx wrapper.HttpContext, config RequestBlockConfig) types.Action {
    requestUrl, _ := proxywasm.GetHttpRequestHeader(":path")   // 取路径
    if !config.caseSensitive { requestUrl = strings.ToLower(requestUrl) }
    for _, blockUrl := range config.blockUrls {
        if strings.Contains(requestUrl, blockUrl) {
            proxywasm.SendHttpResponseWithDetail(config.blockedCode,
                "request-block.url_blocked.keyword", nil,
                []byte(config.blockedMessage), -1)   // 直接返回拦截响应
            return types.ActionContinue
        }
    }
    // ... 检查 block_headers ...
    if len(config.blockBodies) == 0 {
        ctx.DontReadRequestBody()   // :183 不需要读 body 就声明，省内存
    }
    return types.ActionContinue
}

:187-201：请求体到达时，检查 body 是否含关键词：

func onHttpRequestBody(ctx wrapper.HttpContext, config RequestBlockConfig, body []byte) types.Action {
    bodyStr := string(body)
    if !config.caseSensitive { bodyStr = strings.ToLower(bodyStr) }
    for _, blockBody := range config.blockBodies {
        if strings.Contains(bodyStr, blockBody) {
            proxywasm.SendHttpResponseWithDetail(config.blockedCode,
                "request-block.body_blocked", nil, []byte(config.blockedMessage), -1)
            return types.ActionContinue
        }
    }
    return types.ActionContinue
}

README.md 给出应用方式——一个 WasmPlugin CRD（上一站 Higress/Console 讲过）：

apiVersion: extensions.higress.io/v1alpha1
kind: WasmPlugin
metadata:
  name: request-block
  namespace: higress-system
spec:
  defaultConfig:
    block_urls:
    - "swagger.html"     # ← 这就是 parseConfig 里读的 block_urls
  url: oci:///request-block:1.0.0

✋ 动手

cd /Users/bitmart/work/codes/github/higress-group/wasm-go
cat examples/request-block/main.go
# 试着编译（需要 Go 1.24+）
cd examples/request-block && GOOS=wasip1 GOARCH=wasm go build -buildmode=c-shared -o main.wasm main.go && ls -la main.wasm