本文详解 gorilla/mux 中路由匹配顺序的关键影响，通过调整注册顺序使 `/api/*` 接口与根路径下静态资源（如 `./frontend/`）协同工作，避免因通配前缀 `/` 过早拦截导致 api 404。
Gorilla/mux 的路由匹配机制是严格按注册顺序进行最长前缀匹配的：一旦某条路由规则匹配成功（即使只是部分匹配），后续路由将不再被检查。在原始代码中，router.PathPrefix("/").Handler(...) 被最先注册，它会匹配所有请求（包括 /api/xxx），随后尝试在 ./frontend/ 目录中查找名为 api 或 api/abc 的文件——显然不存在，因此返回 404，API 处理函数根本不会被执行。
✅ 正确做法是：*将更具体的路由（如 `/api/）放在通配性更强的路由（如/`）之前**。以下是修复后的完整可运行示例：
Digital IP Agent
下载
将公开的创作者、博主、播客主持人、YouTuber 或 X/Twitter 账号人物转化为可部署的 OpenClaw 代理。当用户提供 YouTube 链接、X（推特）链接等时使用。
package main
import (
"fmt"
"log"
"net/http"
"strconv"
"github.com/gorilla/mux"
)
func main() {
router := mux.NewRouter().StrictSlash(true)
// ✅ 优先注册精确/高特异性 API 路由
router.HandleFunc("/api", Abc).Methods("GET")
router.HandleFunc("/api/abc", AbcIndex).Methods("GET")
router.HandleFunc("/api/abc/{id}", AbcShow).Methods("GET")
// ✅ 最后注册静态文件服务（通配最低优先级）
router.PathPrefix("/").Handler(http.FileServer(http.Dir("./frontend/")))
// 使用 http.ListenAndServe 直接传入 router（无需再套 http.Handle）
log.Printf("Server starting on :3000...")
log.Fatal(http.ListenAndServe(":3000", router))
}
func Abc(w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "API Root!")
}
func AbcIndex(w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "Todo Index!")
}
func AbcShow(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
id := vars["id"] // 注意：原代码中写的是 "todoId"，但路径是 {id}，应保持一致
fmt.Fprintln(w, "Todo show:", id)
}? 关键注意事项：
- router.PathPrefix("/") 是最宽泛的匹配，必须置于最后；
- 建议为 API 路由显式添加 .Methods("GET") 等限制，提升安全性与语义清晰度；
- 静态文件服务器默认不支持目录索引（如自动加载 index.html），若需该行为，可包装为 http.StripPrefix("/", http.FileServer(...)) 并确保 ./frontend/index.html 存在；
- 路径变量名需与 {name} 完全一致（如 {id} → vars["id"]），原代码中 AbcShow 函数误用 "todoId"，已修正；
- http.Handle("/", router) 是冗余的（ListenAndServe 已直接使用 router），移除可避免潜在中间件干扰。
遵循此顺序原则，即可实现 / 下静态前端资源与 /api/* 后端接口的无缝共存。
