Windows环境使用go-swagger出现正则表达式缺失语法错误如何解决

问题原因 #

这个报错是因为RedocOpts配置字段使用错误导致的：RedocURL字段的作用是指定Redoc前端渲染资源的加载地址，你错误将swagger规范文件的路径填入了该字段，触发了Redoc内部的正则解析异常。

解决方案 #

将配置中的RedocURL替换为专门指定swagger规范文件路径的SpecURL字段即可，同时建议将swagger.yaml的路由逻辑优化为直接返回文件，避免FileServer的路径匹配异常：

opts := middleware.RedocOpts{SpecURL: "/swagger.yaml"}
sh := middleware.Redoc(opts, nil)

getRouter.Handle("/docs", sh)
getRouter.HandleFunc("/swagger.yaml", func(w http.ResponseWriter, r *http.Request) {
    http.ServeFile(w, r, "./swagger.yaml")
})

验证步骤 #

• 确认项目根目录下已经通过go-swagger的生成命令正确生成了无语法错误的swagger.yaml文件
• 启动服务后先访问/swagger.yaml路径，确认可以正常返回规范文件内容，不会出现404/500错误
• 再访问/docs路径即可正常加载接口文档

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