Golang开发环境搭建后如何编写第一个API？简易Web服务配置测试-Golang-PHP中文网

直接用 net/http 就能跑通第一个 api，无需框架或外部模块，5 分钟内可验证成功；关键在于正确注册路由、处理端口冲突、设置 content-type，并用 httptest 编写快速单元测试。

golang开发环境搭建后如何编写第一个api？简易web服务配置测试

直接用 net/http 就能跑通第一个 API，不需要框架、不依赖外部模块，5 分钟内可验证成功。

用 `net/http` 启动最简 HTTP 服务

Go 标准库自带完整 HTTP 能力，http.ListenAndServe 是起点。关键不是“能不能”，而是别漏掉两件事：

http.HandleFunc 必须在 ListenAndServe 前注册，否则路由无效
端口被占用时默认 panic，建议用 :0 让系统自动分配空闲端口（测试更稳定）
响应前必须显式设置 Content-Type，否则前端可能解析失败

示例代码：

<pre class="brush:php;toolbar:false;">package main

import (
	"encoding/json"
	"net/http"
)

func handler(w http.ResponseWriter, r *http.Request) {
	w.Header().Set("Content-Type", "application/json")
	json.NewEncoder(w).Encode(map[string]string{"msg": "hello from net/http"})
}

func main() {
	http.HandleFunc("/ping", handler)
	http.ListenAndServe(":8080", nil) // 或 ":0" 用于测试
}

测试时避免手动 `curl`

循环调试

每次改完代码都要切终端敲 curl http://localhost:8080/ping？太慢。真正高效的验证方式是写个测试函数，用 httptest.NewRecorder 拦住请求，不启真实网络、不占端口、秒出结果。

别直接传 nil 给 handler —— handler(recorder, req) 中的 req 必须是 httptest.NewRequest 构造的
recorder.Body.String() 才是响应体内容，recorder.Code 是状态码
测试文件名必须以 _test.go 结尾，函数名以 Test 开头

最小测试片段：

Golang Samber Do

使用 samber/do 在 Golang 中实现依赖注入 — 服务容器、生命周期管理、作用域、健康检查、优雅关闭和模块组织

下载

<pre class="brush:php;toolbar:false;">func TestPingHandler(t *testing.T) {
	req := httptest.NewRequest("GET", "/ping", nil)
	rec := httptest.NewRecorder()
	handler(rec, req)

	if rec.Code != 200 {
		t.Errorf("expected 200, got %d", rec.Code)
	}
	if !strings.Contains(rec.Body.String(), "hello") {
		t.Error("response body missing expected content")
	}
}