Go程序退出时如何关闭http.ListenAndServe释放端口？

你的问题核心在于程序退出时没有优雅关闭HTTP服务器，导致操作系统的端口处于TIME_WAIT状态（或进程未完全释放端口资源），进而重启时提示端口被占用。下面给你一套完整的解决方案：

问题根源分析 #

你原来的代码把http.ListenAndServe放在匿名goroutine里运行，没有任何机制控制它停止。当你强行终止程序（比如调试时停止），Go runtime没有机会主动关闭服务器的listener，操作系统不会立刻释放端口，需要等待TIME_WAIT周期才能复用，这就是为什么你必须手动kill进程的原因。

解决方案：优雅关闭HTTP服务器 #

我们可以通过以下步骤实现程序退出时自动关闭连接：

• 使用http.Server结构体替代直接调用http.ListenAndServe，这样可以调用其Shutdown方法实现优雅关闭
• 监听系统终止信号（比如SIGINT/SIGTERM），收到信号时触发服务器关闭流程
• 设置超时上下文，确保正在处理的请求有时间完成后再退出

修改后的完整代码 #

package main

import (
	"context"
	"fmt"
	"log"
	"movies/dao"
	"net/http"
	"os"
	"os/signal"
	"syscall"
	"time"

	"github.com/gorilla/mux"
)

var d = dao.MoviesDAO{}

// AllMoviesEndPoint show all movies
func AllMoviesEndPoint(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintln(w, "not implemented yet")
}

func init() {
	d.Server = "127.0.0.1"
	d.Database = "movies"
}

func main() {
	// d.Connect()
	router := mux.NewRouter()
	router.HandleFunc("/movies", AllMoviesEndPoint).Methods("GET")

	// 创建http.Server实例，替代直接调用ListenAndServe
	srv := &http.Server{
		Addr:    ":3000",
		Handler: router,
	}

	// 启动HTTP服务在goroutine里，不阻塞主流程
	go func() {
		if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
			log.Fatalf("listen: %s\n", err)
		}
	}()

	// 监听系统终止信号：SIGINT(Ctrl+C)、SIGTERM(系统终止信号)
	quit := make(chan os.Signal, 1)
	signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
	<-quit
	log.Println("Shutting down server...")

	// 设置5秒超时上下文，给正在处理的请求留足完成时间
	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
	defer cancel()

	// 优雅关闭服务器：停止接受新请求，等待现有请求处理完成后关闭
	if err := srv.Shutdown(ctx); err != nil {
		log.Fatal("Server forced to shutdown:", err)
	}

	log.Println("Server exiting")
}

代码关键部分说明 #

• http.Server实例：通过结构体统一管理服务配置，提供了Shutdown方法实现优雅关闭逻辑
• 信号监听：通过signal.Notify捕获终止信号，确保程序在退出前触发关闭流程
• 超时上下文：避免无限等待未完成的请求，超时后强制终止服务
• 错误区分：忽略http.ErrServerClosed（正常关闭的预期错误），只处理致命错误

额外小技巧：端口复用（可选） #

如果你想快速解决端口占用问题，也可以设置SO_REUSEADDR选项允许端口被立即复用。不过这只是临时方案，优雅关闭才是推荐的标准做法。示例代码片段如下：

import "net"

// ...

ln, err := net.Listen("tcp", ":3000")
if err != nil {
	log.Fatal(err)
}
// 设置SO_REUSEADDR选项，允许端口立即复用
if tcpLn, ok := ln.(*net.TCPListener); ok {
	file, err := tcpLn.File()
	if err != nil {
		log.Fatal(err)
	}
	defer file.Close()
	err = syscall.SetsockoptInt(int(file.Fd()), syscall.SOL_SOCKET, syscall.SO_REUSEADDR, 1)
	if err != nil {
		log.Fatal(err)
	}
}

// 用server.Serve启动服务
if err := srv.Serve(ln); err != nil && err != http.ErrServerClosed {
	log.Fatalf("listen: %s\n", err)
}

这样修改后，下次你停止调试程序时，服务器会自动关闭所有连接并释放端口，再也不用手动kill进程啦！

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