如何不使用路由前缀在相同端点下实现不同API版本的切换

你设想的中间件穿透式写法逻辑成立，但原生chi路由器不直接支持该实现：chi对相同HTTP方法+相同路径的路由，后注册的条目会直接覆盖先注册的，不会自动遍历所有匹配路径的路由条目触发fallthrough。

推荐使用统一版本分发封装的方案，既不需要每个接口写重复的版本判断逻辑，也能保持不同版本的处理函数完全分离，代码结构清晰：

第一步：封装通用版本路由注册函数 #

package main

import (
    "net/http"
    "github.com/go-chi/chi/v5"
)

// VersionHandler 定义版本号到对应处理函数的映射
type VersionHandler map[string]http.HandlerFunc

// HandleVersion 统一注册多版本同路径路由
// method: HTTP方法，path: 接口路径，handlers: 各版本处理函数映射，fallback: 版本不匹配时的默认处理
func HandleVersion(r chi.Router, method, path string, handlers VersionHandler, fallback http.HandlerFunc) {
    r.Method(method, path, func(w http.ResponseWriter, r *http.Request) {
        reqVersion := r.Header.Get("Accept-version")
        if handler, ok := handlers[reqVersion]; ok {
            handler(w, r)
            return
        }
        fallback(w, r)
    })
}

第二步：业务层注册使用 #

func main() {
    r := chi.NewRouter()
    
    // 注册单个接口的多版本实现，无冗余判断逻辑
    HandleVersion(r, http.MethodGet, "/test", VersionHandler{
        "v1": func(w http.ResponseWriter, r *http.Request) {
            w.Write([]byte("version 1 of api"))
        },
        "v2": func(w http.ResponseWriter, r *http.Request) {
            w.Write([]byte("version 2 of api"))
        },
    }, func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte("other version of api"))
    })

    // 其他接口同理注册即可
    // HandleVersion(r, http.MethodPost, "/user", ...)
    
    http.ListenAndServe(":8080", r)
}

该方案的优势：

• 所有版本判断逻辑收拢到统一封装层，业务代码无冗余
• 不同版本的处理函数完全独立，可拆分到不同的v1/v2业务包维护，不会混杂
• 接口数量再多也不会出现代码混乱的问题

如果一定要使用r.With(UseVersion1).Get(...)的链式风格，可以在上述封装的基础上扩展自定义路由包装类，底层仍用统一分发逻辑，对外暴露和原生chi完全一致的链式调用API即可，不需要修改chi底层源码。

• 可以将解析到的版本号写入请求上下文，后续业务处理函数不需要重复读取Header
• 可增加版本号合法性校验，非法版本直接返回400错误，不需要走到fallback逻辑
• 版本数量较多时，可按版本拆分路由注册逻辑到不同文件，进一步降低代码耦合

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