最简方式是直接调用http.ListenAndServe(":8080", nil)，它内置于net/http标准库，零配置即可启动HTTP服务，但必须检查错误以避免端口占用等导致静默失败。
Go语言启动HTTP服务最简方式是什么
直接用 http.ListenAndServe 就能跑起来，不需要额外框架或依赖。它内置在标准库 net/http 中，零配置即可监听端口并响应请求。
常见错误是忽略返回值，导致服务崩溃却无感知；或者端口被占用时程序 panic 而没做错误处理。
-
http.ListenAndServe默认使用http.DefaultServeMux作为路由分发器 - 第二个参数传
nil表示使用默认多路复用器，传自定义http.Handler则完全接管请求逻辑 - 端口写法必须带冒号，比如
":8080"，不能只写8080
package mainimport ( "fmt" "log" "net/http" )
func main() { http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) { fmt.Fprintf(w, "Hello, World!") })
log.Println("Server starting on :8080") if err := http.ListenAndServe(":8080", nil); err != nil { log.Fatal(err) // 必须检查错误，否则端口占用时静默失败 }}
如何自定义HTTP Handler结构体
当逻辑变复杂、需要状态或依赖注入时，函数式注册（
http.HandleFunc）就不够用了。此时应实现http.Handler接口，即定义含ServeHTTP(http.ResponseWriter, *http.Request)方法的结构体。立即学习“go语言免费学习笔记（深入）”；
注意：结构体方法签名必须严格匹配接口定义，参数类型、顺序、指针接收都不能错；否则编译不通过。
- 用指针接收可修改结构体字段（如计数器、配置、DB连接）
- 结构体字段可预加载依赖，避免每次请求都初始化
- 不推荐在
ServeHTTP中做耗时同步操作，会阻塞整个 goroutine
type CounterHandler struct {
count int
}
func (h CounterHandler) ServeHTTP(w http.ResponseWriter, r http.Request) {
h.count++
fmt.Fprintf(w, "Request count: %d", h.count)
}
func main() {
handler := &CounterHandler{count: 0}
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", handler))
}
为什么有时候要替换 DefaultServeMux
直接用 http.HandleFunc 看似方便，但所有路由都注册到全局唯一的 http.DefaultServeMux，容易引发冲突——尤其在引入第三方包时，它们也可能调用 http.HandleFunc 注册路径。
更严重的是：DefaultServeMux 不支持中间件、无法统一日志/超时/跨域，也不支持子路由嵌套。
- 显式创建新
http.ServeMux实例，用其HandleFunc方法注册路由，彻底隔离作用域 - 后续可轻松替换为
gorilla/mux或chi等增强型路由库，只需改初始化部分 - 调试时打印路由表更清晰：
mux.ServeMux没有公开导出的路由列表，但自定义 mux 更易控制
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/api/", apiHandler)
mux.HandleFunc("/health", healthHandler)
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", mux))}
HTTP Server 启动后如何优雅关闭
生产环境不能粗暴 kill 进程，否则正在处理的请求会被中断。Go 提供了 http.Server 类型和 Shutdown 方法来支持优雅退出。
关键点在于：必须保存 *http.Server 实例，不能只调用 http.ListenAndServe；且 Shutdown 需配合信号监听（如 os.Interrupt）。
-
Shutdown会先关闭监听 socket，再等待已有请求完成（默认无超时），建议设置Context带超时 - 不要在
Shutdown后继续调用ListenAndServe，会导致http: Server closed错误 - 若用
http.DefaultServeMux，需手动传给http.Server的Handler字段
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
time.Sleep(2 * time.Second) // 模拟长请求
fmt.Fprintf(w, "Done")
})
server := &http.Server{
Addr: ":8080",
Handler: mux,
}
go func() {
if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
log.Fatal(err)
}
}()
sig := make(chan os.Signal, 1)
signal.Notify(sig, os.Interrupt)
<-sig
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
if err := server.Shutdown(ctx); err != nil {
log.Fatal(err)
}
log.Println("Server gracefully stopped")}
实际项目中，最容易被忽略的是：把 http.ListenAndServe 当成黑盒，不处理错误、不设超时、不关服务。一旦部署到容器或 systemd，这些细节直接决定服务是否可运维。
