使用net/http.Server可精细控制HTTP服务,示例中设置超时、自定义路由,并通过信号监听实现优雅关闭,结合日志与HTTPS配置,提升服务稳定性与安全性。

使用Golang启动一个HTTP服务并不复杂,net/http 包提供了简洁而强大的接口来实现。其中 net/http.Server 结构体允许你更精细地控制服务器行为,比如设置超时、连接数限制、TLS配置等。下面介绍如何正确使用它来启动和管理HTTP服务。
创建基础HTTP服务
最简单的做法是使用 http.ListenAndServe,但为了更好的控制力,推荐直接实例化 http.Server。
示例代码:
package mainimport ( "log" "net/http" "time" )
func main() { mux := http.NewServeMux() mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) { w.Write([]byte("Hello, Golang HTTP Server!")) })
server := &http.Server{ Addr: ":8080", Handler: mux, ReadTimeout: 5 * time.Second, WriteTimeout: 10 * time.Second, IdleTimeout: 120 * time.Second, } log.Println("Server starting on :8080") if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed { log.Fatalf("Server failed: %v", err) }}
立即学习“go语言免费学习笔记(深入)”;
这里我们显式设置了读写和空闲超时,避免连接长时间占用资源。Handler 使用自定义的 ServeMux 路由器,便于后续扩展。
优雅关闭服务
在生产环境中,强制终止服务可能导致正在处理的请求丢失。应通过信号监听实现优雅关闭。
实现方式:
package mainimport ( "context" "log" "net/http" "os" "os/signal" "syscall" "time" )
func main() { mux := http.NewServeMux() mux.HandleFunc("/", func(w http.ResponseWriter, r http.Request) { // 模拟耗时操作 time.Sleep(2 time.Second) w.Write([]byte("Request processed.")) })
server := &http.Server{ Addr: ":8080", Handler: mux, } // 启动服务器(在goroutine中) go func() { log.Println("Starting server on :8080") if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed { log.Fatalf("Server error: %v", err) } }() // 等待中断信号 c := make(chan os.Signal, 1) signal.Notify(c, syscall.SIGINT, syscall.SIGTERM) <-c log.Println("Shutting down server...") // 创建上下文用于限制关闭超时 ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second) defer cancel() // 优雅关闭 if err := server.Shutdown(ctx); err != nil { log.Printf("Server shutdown error: %v", err) } log.Println("Server stopped.")}
立即学习“go语言免费学习笔记(深入)”;
当接收到中断信号后,Shutdown 会停止接收新请求,并等待正在进行的请求完成或超时。这能有效避免数据不一致或客户端错误。
配置日志与错误处理
默认情况下,HTTP服务器的日志输出较为简单。你可以通过自定义中间件记录访问日志,也可以替换 server.ErrorLog 来集中处理内部错误。
例如:
logger := log.New(os.Stdout, "http: ", 0)
server := &http.Server{
Addr: ":8080",
Handler: withLogging(mux), // 自定义日志中间件
ErrorLog: logger, // 记录内部错误如超时、解析失败等
}
withLogging 是一个包装函数,可以在每次请求前后打印信息,比如请求方法、路径、响应时间等。
启用HTTPS服务
切换到HTTPS只需调用 ListenAndServeTLS 方法,并提供证书文件路径。
server := &http.Server{
Addr: ":443",
Handler: mux,
}
log.Println("Starting HTTPS server on :443")
err := server.ListenAndServeTLS("cert.pem", "key.pem")
if err != nil {
log.Fatalf("HTTPS server failed: %v", err)
}
确保你的域名证书有效,并考虑使用 Let's Encrypt 免费获取证书。若需同时支持HTTP跳转HTTPS,可另启一个HTTP服务器做重定向。
基本上就这些。使用 net/http.Server 能让你更好地掌控服务生命周期、安全性和性能表现。合理设置超时、实现优雅关闭、添加日志监控,是构建稳定HTTP服务的关键步骤。










