如何在oapi-codegen的net/http strict server中部署Flutter Web应用？

针对你遇到的两个问题，提供两种可行的解决方向：

方向一：让静态资源路由绕过验证中间件 #

核心思路是拆分路由，仅让API请求经过验证中间件，静态资源请求直接处理，不经过验证逻辑。

• 步骤：
  1. 分别创建两个http.ServeMux：一个专门处理API路由，一个处理静态资源。
  2. 将验证中间件仅挂载到API专用的Mux上。
  3. 主Mux分别注册API前缀路由（如/api/*）到带验证的API Mux，静态资源路由（如/）直接注册http.FileServer。

代码示例：

import (
    "net/http"
    generated "your/api/generated/path"
    "github.com/oapi-codegen/nethttp-middleware"
)

func main() {
    // 初始化你的API实现
    apiImpl := &YourApiImplementation{}
    // 创建strict-server模式的API handler
    apiHandler := generated.NewStrictHandler(apiImpl, generated.StrictHTTPServerOptions{})
    
    // 构建API专用Mux并挂载验证中间件
    apiMux := http.NewServeMux()
    generated.RegisterHandlers(apiMux, apiHandler)
    // 加载你的OpenAPI规范文件
    spec, _ := generated.GetSwagger()
    validatedApi := nethttpmiddleware.OapiRequestValidatorWithOptions(spec, nethttpmiddleware.Options{})(apiMux)
    
    // 主路由Mux
    mainMux := http.NewServeMux()
    // 注册API路由，所有/api开头的请求走验证后的API Mux
    mainMux.Handle("/api/", http.StripPrefix("/api", validatedApi))
    // 注册静态资源路由，指向Flutter Web的dist目录
    mainMux.Handle("/", http.FileServer(http.Dir("./dist")))
    
    // 启动服务器
    if err := http.ListenAndServe(":8080", mainMux); err != nil {
        panic(err)
    }
}

这种方式无需修改OpenAPI规范，静态资源请求不会被验证中间件拦截，同时API路由的验证逻辑保持完整，是最直接的解决方案。

方向二：在strict-server模式下适配FileServer输出 #

如果必须将静态资源路由纳入OpenAPI规范，可以通过捕获FileServer的输出，转换成生成的TexthtmlResponse类型返回。

• 步骤：
  1. 在OpenAPI规范中添加静态资源路由（比如GET /和GET /{path:*}），并指定content: text/html: {}。
  2. 在实现对应的handler时，使用httptest.ResponseRecorder捕获FileServer的响应内容。
  3. 从Recorder中提取状态码、响应头和body，构建成生成的响应类型返回。

代码示例：

import (
    "net/http"
    "net/http/httptest"
    generated "your/api/generated/path"
)

type YourApiImplementation struct{}

// 对应OpenAPI中定义的GET /路由
func (s *YourApiImplementation) GetIndex(w http.ResponseWriter, r *http.Request) (generated.TexthtmlResponse, error) {
    // 创建ResponseRecorder捕获FileServer的输出
    rr := httptest.NewRecorder()
    // 指向Flutter Web的静态资源目录
    fs := http.FileServer(http.Dir("./dist"))
    // 让FileServer处理当前请求
    fs.ServeHTTP(rr, r)
    
    // 构建生成的TexthtmlResponse对象
    resp := generated.TexthtmlResponse{
        StatusCode: rr.Code,
        Headers:    rr.Header().Clone(),
        Body:       rr.Body.Bytes(),
    }
    return resp, nil
}

// 对应OpenAPI中定义的GET /{path:*}通配符路由
func (s *YourApiImplementation) GetPath(w http.ResponseWriter, r *http.Request, path string) (generated.TexthtmlResponse, error) {
    rr := httptest.NewRecorder()
    fs := http.FileServer(http.Dir("./dist"))
    fs.ServeHTTP(rr, r)
    
    resp := generated.TexthtmlResponse{
        StatusCode: rr.Code,
        Headers:    rr.Header().Clone(),
        Body:       rr.Body.Bytes(),
    }
    return resp, nil
}

这种方式需要维护OpenAPI规范中的静态路由，但能满足路由必须在规范中注册的场景。

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