可将 http.servemux 整合进 revel 应用以复用第三方端点，需在 onappstart 钩子中替换 revel.server.handler，确保自定义路径注册在兜底处理器之前，并通过 curl 验证是否生效。
将已有的 http.ServeMux 整合进 Revel 应用，是为了复用已有路由逻辑（如第三方健康检查端点、Prometheus metrics 路径、/debug/pprof）、避免重写或迁移，同时保留 Revel 的控制器、过滤器、模板等核心能力。
确认 ServeMux 与 Revel 的协作边界
Revel 自身不提供原生的 ServeMux 注册接口，它通过 revel.Server.Handler 暴露底层 HTTP 处理器。该字段默认指向 Revel 内置的请求分发器，但可被完全替换——【替换前必须确保 Revel 过滤器链已初始化完毕，否则自定义 mux 将绕过所有 revel.Filter，如 session、panic recovery、router】。
关键约束：ServeMux 只能处理路径前缀，不能替代 Revel 的控制器机制；/api/v1/* 等路径可交由 mux，而 /app/*、/admin/* 等需保持由 Revel 路由接管。
在 Revel 启动时注入自定义 ServeMux
方法一：使用 OnAppStart 钩子封装替换逻辑
第一步：在 app/init.go 的 init() 函数中注册启动钩子：
revel.OnAppStart(installCustomMux)
第二步：定义 installCustomMux 函数，创建新 mux 并挂载 Revel 主处理器和自定义 handler：
func installCustomMux() {<br> customMux := http.NewServeMux()<br> customMux.Handle("/", revel.Server.Handler) // Revel 默认路由兜底<br> customMux.Handle("/health", healthHandler())<br> customMux.Handle("/metrics", promhttp.Handler())<br> revel.Server.Handler = customMux<br>}
注意：此处 revel.Server.Handler = customMux 是唯一生效入口，不可在 main() 中重复赋值，否则会被 Revel 启动流程覆盖。
处理路径冲突与路由优先级
方法二：显式声明路径覆盖顺序，避免 /health 被 Revel 路由拦截
Revel 的默认路由匹配是“最长路径优先”，但 ServeMux 是“注册顺序优先”。若你先注册 customMux.Handle("/", revel.Server.Handler)，再注册 customMux.Handle("/health", ...)，则 /health 会命中；反之则被兜底处理器捕获并抛出 404。
必须确保所有自定义路径注册在 revel.Server.Handler 之前，且路径末尾不带通配符（如不要写 "/health/"，除非你明确要匹配子路径）。
方法三：用子路径隔离，规避全局冲突
将外部 handler 统一挂载到独立前缀下，例如：
customMux.Handle("/_ext/health", healthHandler())<br>customMux.Handle("/_ext/metrics", promhttp.Handler())
这样既避免与 Revel routes.conf 中定义的任何路径重叠，又无需修改现有 handler 的内部路径逻辑。
验证集成是否生效
启动 Revel 应用后，直接访问 curl -I http://localhost:9000/health。
若返回 200 OK 且响应头含 Content-Type: application/json，说明 ServeMux 已接管该路径；若返回 404 或进入 Revel 的 404 页面，则检查 installCustomMux 是否被正确调用、路径注册顺序是否颠倒、以及 Revel 是否处于开发模式（REVEL_RUNMODE=dev 下部分钩子行为有差异）。
