Golang基于WaitGroup实现优雅关闭时TLS Webserver启动失败问题

问题根因 #

1. 测试逻辑的自动关闭触发过早

你的主线程启动完HTTP、HTTPS服务后仅设置了5秒休眠，就主动调用Shutdown()方法关闭了两个服务。结合日志时间线可以验证：

• 16:12:11 服务完成启动
• 16:12:14 你访问HTTP服务时还在5秒窗口内，所以可以正常返回重定向响应
• 浏览器跳转到HTTPS站点时已经接近/超过5秒，服务已经被关闭，自然返回超时错误。

2. 潜在规范问题：HTTPS服务实例未显式绑定路由

你当前所有HTTPS的路由都是注册在全局默认的http.DefaultServeMux上，HTTPS服务实例未显式指定Handler字段，虽然默认也会走全局Mux，但多服务场景下很容易出现路由污染。另外你在startHttpsServer内部调用了flag.Parse()，如果主函数已经执行过参数解析，这里的devFS参数会读取失效。

修复方案 #

1. 调整测试逻辑的休眠时间，将time.Sleep(5 * time.Second)改为更长的时间（比如time.Hour）用于功能验证；生产环境替换为监听系统退出信号的逻辑，仅在每日0点续签证书时才主动调用Shutdown()。
2. 规范HTTPS服务的路由绑定逻辑，把参数解析移到主函数，给HTTPS服务单独绑定Mux避免全局污染，参考修正后的startHttpsServer代码：

// 把devFS参数定义移到主函数中解析，不要放在服务启动函数内
func startHttpsServer(wg *sync.WaitGroup, devFS bool) *http.Server {
    // 初始化独立的Mux，不和其他服务共享路由
    mux := http.NewServeMux()
    srvHTTPS := &http.Server{
        Addr: ":" + config.PortHTTPS,
        Handler: mux, // 显式绑定自定义Mux
    }

    //BasicAuth
    authentificator := auth.NewBasicAuthenticator("Dlock", secretForWebUser)

    //Static sites
    fs := http.FileServer(assets)
    if devFS {
        fmt.Printf("Use local dev file sytem\n")
        fs = http.FileServer(http.Dir("../web/files"))
    }
    // 路由注册到当前服务的独立Mux上
    mux.HandleFunc("/", authentificator.Wrap(func(w http.ResponseWriter, req *auth.AuthenticatedRequest) {
        fs.ServeHTTP(w, &req.Request)
    }))

    //Main-API 同样注册到独立Mux
    mux.HandleFunc("/dlock/v1/management/add", authentificator.Wrap(func (w http.ResponseWriter, r *auth.AuthenticatedRequest) {
        newHttpRequest("/dlock/v1/management/add", &r.Request, &w)
    }))
    mux.HandleFunc("/dlock/v1/management/get", authentificator.Wrap(func (w http.ResponseWriter, r *auth.AuthenticatedRequest) {
        newHttpRequest("/dlock/v1/management/get", &r.Request, &w)
    }))
    mux.HandleFunc("/dlock/v1/websv", authentificator.Wrap(func (w http.ResponseWriter, r *auth.AuthenticatedRequest) {
        newHttpRequest("/dlock/v1/websv", &r.Request, &w)
    }))

    go func() {
        defer wg.Done()
        log.Printf("Starting HTTPS Server on Port %s", config.PortHTTPS)

        if err := srvHTTPS.ListenAndServeTLS(config.Crt, config.Key); err != http.ErrServerClosed {
            log.Fatalf("Error with HTTPS-Server: %s", err)
        }       
    }()

    return srvHTTPS
}

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