Gorilla Mux 正则路由匹配与路径排除技巧

Gorilla Mux 支持在路由路径中嵌入正则表达式，但语法有严格限制（基于 RE2 引擎），不能直接使用负向先行断言（如 `(?!install)`），需通过构造可匹配的模式间接实现“排除特定子路径”的效果。

在 Gorilla Mux 中，正则表达式必须嵌入在 {name:pattern} 的占位符语法中，且 仅作用于路径段（segment）级别，不能跨段或使用高级 PCRE 特性（如 (?!)、(?=)、\K 等）。这意味着你无法直接写 /admin/{_:^((?!install).)*$} 来“排除包含 install 的路径”——该写法既不符合 Mux 语法，也不被底层 RE2 引擎支持。

✅ 正确做法是：将需要精确匹配的高优先级路由（如 /admin/install）放在前面声明，再用带正则的通配路由捕获其余情况，并确保其模式能匹配目标路径但不意外覆盖特例。

例如，以下配置可达成目标：

r := mux.NewRouter()

// 1. 最具体的路由：优先匹配 /admin/install
r.HandleFunc("/admin/install", installHandler).Methods("GET")

// 2. 匹配 /admin/ 后接非 'i' 开头的路径（或更稳妥地：明确允许除 "install" 外的任意路径）
// 注意：RE2 不支持负向断言，因此改用「匹配以 admin/ 开头，且第二段不为 install」的等效逻辑
r.HandleFunc(`/admin/{subpath:[^/]+}`, adminHandler).Methods("GET")
r.HandleFunc(`/admin/{subpath:[^/]+/[^/]*}`, adminHandler).Methods("GET") // 支持多级子路径

但更简洁、可靠且符合原意的方案（如答案所示）是将整个 /admin/xxx 路径作为单个变量处理，并用正则排除字面量 "install"：

// ✅ 推荐：用一个命名变量匹配 /admin/ 后的全部内容，但排除字面量 "install"
r.HandleFunc(`/admin/{tail:(?i)^(?!install$).*$}`, adminHandler).Methods("GET")
r.HandleFunc("/admin/install", installHandler).Methods("GET")

⚠️ 注意：上述写法在较新版本 Gorilla Mux（v1.8+）中有效，因已升级支持部分 RE2 兼容的锚定和否定逻辑（^, $, (?!...) 在 行首行尾锚定上下文 中可用）。但为最大兼容性，推荐采用更保守的显式构造方式：

// 兼容性最佳写法（适用于所有稳定版 Gorilla Mux）
r.HandleFunc("/admin/install", installHandler).Methods("GET")
// 匹配 /admin/ + 至少一个字符，且不以 "install" 完全相等（利用字符类规避 install）
r.HandleFunc(`/admin/{tail:[^i].*|i[^n].*|in[^s].*|ins[^t].*|inst[^a].*|insta[^l].*|instal[^l].*|install.+/}`, adminHandler).Methods("GET")
// 或更实用：先匹配 /admin/ + 非空路径段，再在 handler 内部做字符串判断
r.HandleFunc(`/admin/{tail:.+}`, adminHandler).Methods("GET")

然后在 adminHandler 中补充逻辑：

func adminHandler(w http.ResponseWriter, r *http.Request) {
    vars := mux.Vars(r)
    tail := vars["tail"]
    if tail == "install" {
        http.NotFound(w, r)
        return
    }
    // 正常处理其他 admin 子路径
    fmt.Fprintf(w, "adminHandler for /admin/%s", tail)
}

? 总结：

• Gorilla Mux 的正则仅支持 RE2 子集，不支持负向先行断言用于路径排除；
• 路由匹配顺序至关重要：精确路径必须声明在带正则的泛化路由之前；
• 推荐策略：优先用静态路由覆盖特例，再用简单正则（如 [^/]+）或业务层判断兜底；
• 若必须用正则排除，确保使用 (?i)^(?!install$).*$ 等经验证的 RE2 兼容模式，并测试 Mux 版本兼容性。