Golang原生API开发：GET请求/users/:id返回404问题排查

核心问题是Go标准库的http.ServeMux不支持/users/:id这种动态参数占位符的路由语法，它只会精确匹配你注册的路径字符串。也就是说，只有当你请求http://localhost:8080/users/:id时，这个处理器才会被触发，而你的UUID路径/users/45254424-5be1-487d-9131-bad3b2f7791c完全不匹配，所以返回404。

解决方法 #

方法一：使用前缀路由匹配 #

ServeMux支持前缀匹配规则：如果注册的路径以/结尾，它会匹配所有以该前缀开头的路径。你可以把用户详情的路由改成/users/，并保留原有的/users处理POST请求：

mux := http.NewServeMux()

// 处理POST /users 创建用户
mux.HandleFunc("/users", func(writer http.ResponseWriter, request *http.Request) {
    if request.Method == "POST" {
        userHandler.Create(writer, request)
    } else {
        http.Error(writer, "Invalid request method", http.StatusMethodNotAllowed)
    }
})

// 处理GET /users/{id} 获取用户详情（前缀匹配所有/users/开头的路径）
mux.HandleFunc("/users/", func(writer http.ResponseWriter, request *http.Request) {
    if request.Method == "GET" {
        userHandler.GetById(writer, request)
    } else {
        http.Error(writer, "Invalid request method", http.StatusMethodNotAllowed)
    }
})

mux.HandleFunc("/ping", PingHandler)

err := http.ListenAndServe(":8080", mux)
log.Fatal(err)

你的GetById处理器代码不需要修改，strings.TrimPrefix(request.URL.Path, "/users/")可以正确提取出UUID。

方法二：统一在/users路由处理所有请求 #

也可以把/users和/users/{id}的逻辑合并到同一个处理器里，通过判断路径和请求方法来分发：

mux.HandleFunc("/users", func(writer http.ResponseWriter, request *http.Request) {
    switch request.Method {
    case http.MethodPost:
        userHandler.Create(writer, request)
    case http.MethodGet:
        // 判断是否是详情请求（路径不是/users本身）
        if request.URL.Path != "/users" {
            userHandler.GetById(writer, request)
        } else {
            // 可选：处理获取用户列表的逻辑
            http.Error(writer, "User list endpoint not implemented", http.StatusNotImplemented)
        }
    default:
        http.Error(writer, "Invalid request method", http.StatusMethodNotAllowed)
    }
})

补充说明 #

Go标准库http.ServeMux的匹配优先级是：

1. 优先匹配完全一致的路径
2. 再匹配以/结尾的前缀路径
3. 都不匹配则返回404

所以不要用:id这种框架专属的语法，标准库不识别这种动态参数占位符。

内容的提问来源于stack exchange，提问作者Fatih