Gorilla Mux 提供了 NotFoundHandler 字段，允许开发者轻松设置全局 404 处理函数，无需手动检查路径或使用贪婪路由，即可统一响应未匹配的请求。
gorilla mux 提供了 notfoundhandler 字段，允许开发者轻松设置全局 404 处理函数，无需手动检查路径或使用贪婪路由，即可统一响应未匹配的请求。
在使用 Gorilla Mux 构建 Web 应用时，当请求路径未被任何显式注册的路由匹配时，Mux 默认会返回标准的 HTTP 404 响应（内容为空、状态码为 404）。但生产环境中，我们通常需要返回友好的 HTML 页面、结构化 JSON 错误信息，或记录日志、执行重定向等逻辑——这时，自定义 NotFoundHandler 就成为关键。
Gorilla Mux 的 *mux.Router 结构体公开了一个可赋值的字段：
NotFoundHandler http.Handler
它是一个符合 http.Handler 接口的值（即实现了 ServeHTTP(http.ResponseWriter, *http.Request) 方法的对象），会在所有已注册路由均未匹配时被调用。
✅ 正确做法如下：
ImageMagick 批处理处理器
下载
使用 ImageMagick 的 convert 和 mogrify 命令进行批量图像处理，支持调整大小、裁剪、水印和格式转换。与 libvips 集成以实现高性能缩略图生成。
package main
import (
"fmt"
"net/http"
"github.com/gorilla/mux"
)
func handler(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
fmt.Fprintf(w, "Hi there, I love %s!", vars["username"])
}
func homeHandler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Welcome to the homepage!")
}
// 自定义 404 处理器
func custom404Handler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "text/html; charset=utf-8")
w.WriteHeader(http.StatusNotFound)
fmt.Fprintln(w, "<h1>❌ Page Not Found</h1>")
fmt.Fprintln(w, "<p>The requested URL <code>", r.URL.Path, "</code> does not exist.</p>")
fmt.Fprintln(w, "<a href='/'>← Go home</a>")
}
func main() {
r := mux.NewRouter()
// 注册具体路由
r.HandleFunc("/help/{username}/", handler).Methods("GET")
r.HandleFunc("/", homeHandler).Methods("GET")
// ✅ 关键：设置全局 NotFoundHandler
r.NotFoundHandler = http.HandlerFunc(custom404Handler)
// 启动服务器（注意：传入 r，而非 nil）
http.ListenAndServe(":8080", r)
}⚠️ 注意事项：
-
r.NotFoundHandler必须在http.ListenAndServe传入路由器实例（r）时生效；若像原代码中传入nil（http.ListenAndServe(":8080", nil)），则NotFoundHandler不会被调用，因为nil表示使用默认http.DefaultServeMux，与r无关。 -
NotFoundHandler是兜底机制，仅在无任何路由匹配（包括方法不匹配）时触发。例如，若某路径注册了GET但收到POST请求，也会进入NotFoundHandler（除非你额外配置了MethodNotAllowedHandler）。 - 若需同时自定义 405（Method Not Allowed），可设置
r.MethodNotAllowedHandler。 - 为保持一致性，建议将
custom404Handler显式转为http.HandlerFunc（如示例所示），确保类型安全。
? 小技巧：你也可以复用现有处理器（如返回 JSON）：
r.NotFoundHandler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusNotFound)
json.NewEncoder(w).Encode(map[string]string{"error": "route not found"})
})通过合理配置 NotFoundHandler，你可以快速构建健壮、用户体验良好的错误处理层，而无需侵入每个路由逻辑。
