还记得 Day 04 说 CommonPluginCtx 内嵌了 RuleMatcher。当请求进入某个处理钩子前，SDK 会调 GetMatchConfig() 选出当前请求该用的配置，再把它作为 config 参数传给你的钩子。

GetMatchConfig（rule_matcher.go:122-140）开头取当前请求的三个关键信息：

host, _ := proxywasm.GetHttpRequestHeader(":authority")       // 域名
routeName, _ := proxywasm.GetProperty([]string{"route_name"}) // Envoy 匹配的路由名
serviceName, _ := proxywasm.GetProperty([]string{"cluster_name"}) // 后端集群名

rule_matcher.go:140-176：遍历所有规则，按 category 判断是否命中：

for _, rule := range m.ruleConfig {
    if rule.category == Host && m.hostMatch(rule, host) {
        return &rule.config, nil
    }
    if rule.category == Route {
        if _, ok := rule.routes[string(routeName)]; ok { return &rule.config, nil }
    }
    if rule.category == Service && m.serviceMatch(rule, string(serviceName)) {
        return &rule.config, nil
    }
    if rule.category == RouteAndService {
        if _, ok := rule.routes[string(routeName)]; ok && m.serviceMatch(rule, string(serviceName)) {
            return &rule.config, nil
        }
    }
    if rule.category == RoutePrefix {
        for routePrefix := range rule.routePrefixs {
            if strings.HasPrefix(string(routeName), routePrefix) { return &rule.config, nil }
        }
    }
}

hostMatch 按昨天的三种 MatchType 处理通配：

• Exact：域名完全相等。
• Prefix（*.example.com）：请求域名以 .example.com 结尾。
• Suffix（example.*）：请求域名以 example. 开头。

rule_matcher.go:176-180：所有规则都没命中时——

    if m.hasGlobalConfig {
        return &m.globalConfig, nil   // 用全局配置兜底
    }
    return nil, nil                    // 没有全局配置，返回 nil
}

对插件作者，这一切是透明的。你只需：

func onHttpRequestHeaders(ctx wrapper.HttpContext, config MyConfig) types.Action {
    // config 已经是匹配出来的正确配置，直接用
    if config.enabled { /* ... */ }
    return types.ActionContinue
}

✋ 动手

cd /Users/bitmart/work/codes/github/higress-group/wasm-go
sed -n '122,180p' pkg/matcher/rule_matcher.go
grep -n "hostMatch\|serviceMatch" pkg/matcher/rule_matcher.go pkg/matcher/utils.go