使用mux构建的Golang API Server无法接收SwaggerUI请求求助

核心问题定位 #

你当前的代码存在几个直接导致请求失败的问题：

• 允许的请求头列表缺失Content-Type字段：SwaggerUI发起POST JSON请求时默认会携带Content-Type: application/json头，你当前配置的AllowedHeaders未包含该字段，会直接导致预检OPTIONS请求被拦截，后续业务请求不会发出
• 允许的源配置大概率未生效：你通过os.Getenv("ORIGIN_ALLOWED")读取允许的源，若未提前配置对应环境变量，该值为空，SwaggerUI所在的域名/端口不在白名单内，CORS校验直接失败
• 冗余代码可能造成冲突：你同时调用了http.Handle("/", server)和在ListenAndServe中传入包装后的路由，多余配置可能引发不可预期的路由匹配问题

排查步骤 #

1. 打开浏览器开发者工具的「网络」面板，重新触发SwaggerUI请求，确认是否是OPTIONS预检请求返回了4xx错误，若存在该现象可确定是CORS配置问题
2. 打印os.Getenv("ORIGIN_ALLOWED")的返回值，确认与你当前打开的SwaggerUI页面的源（协议+域名+端口，比如http://localhost:8080）完全一致，本地调试阶段可临时设置为[]string{"*"}放开所有源限制验证
3. 在路由中添加简单的日志中间件，确认SwaggerUI的请求是否真的没有到达服务端，若完全无日志，需要检查SwaggerUI的接口请求地址是否配置错误（比如端口写错、协议写成https等）

修正后参考代码 #

server := mux.NewRouter()
server.HandleFunc("/api/people/", addPerson).Methods("POST")

// 调试阶段可先放开所有限制验证连通性，上线前再收紧
headersOk := handlers.AllowedHeaders([]string{"Accept", "Content-Type", "X-Requested-With"})
// 若不需要配置环境变量，直接写死允许的源，本地调试可用*
originsOk := handlers.AllowedOrigins([]string{"*"})
// 显式添加OPTIONS方法允许，适配CORS预检逻辑
methodsOk := handlers.AllowedMethods([]string{"GET", "DELETE", "POST", "PUT", "PATCH", "OPTIONS"})

// 删掉多余的http.Handle配置
log.Fatal(http.ListenAndServe(":8080", handlers.CORS(originsOk, headersOk, methodsOk)(server)))

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