如何正确编写 Go Web 应用的单元测试（以 net/http 为例）

go 测试文件不应包含 main 函数，而应使用以 `test` 开头的函数定义测试用例，并与被测代码同属 `package main`；`go test` 会自动识别并执行这些测试函数。

在 Go 中编写 Web 应用（如基于 net/http 的服务）的测试时，一个常见误区是直接将官方 httptest 示例中的 main() 函数复制到 _test.go 文件中——这会导致编译失败，因为同一个包内不允许存在多个 main 函数（尤其当主程序文件 beacon.go 已定义 func main() 时）。

✅ 正确做法是：

• 所有 .go 和 _test.go 文件必须属于同一包（例如 package main），否则 go build 或 go test 会报错：“found packages main and xxx”。
• 测试函数必须以大写字母 Test 开头，后接驼峰命名（如 TestHandlerReturnsOK），且接收唯一参数 *testing.T。
• 不需要、也不允许在测试文件中定义 main() 函数——go test 是独立的测试驱动程序，它会自动加载并运行符合规范的测试函数。

下面是一个完整示例：

// beacon.go
package main

import (
    "fmt"
    "net/http"
)

func handler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprint(w, "Hello, Beacon!")
}

func main() {
    http.HandleFunc("/", handler)
    http.ListenAndServe(":8080", nil)
}

// beacon_test.go
package main

import (
    "net/http"
    "net/http/httptest"
    "testing"
)

func TestHandlerReturnsOK(t *testing.T) {
    req := httptest.NewRequest("GET", "/", nil)
    w := httptest.NewRecorder()

    handler(w, req)

    if w.Code != http.StatusOK {
        t.Errorf("expected status OK; got %v", w.Code)
    }

    expected := "Hello, Beacon!"
    if w.Body.String() != expected {
        t.Errorf("expected body %q; got %q", expected, w.Body.String())
    }
}

? 注意事项：

• ✅ 运行测试：在项目根目录执行 go test -v（-v 显示详细输出）。
• ❌ 不要修改测试文件的 package 名称（如改为 package hello），否则 Go 无法将测试与被测代码关联。
• ? 若项目结构复杂（如含多个子包），建议将 HTTP 处理逻辑提取至独立包（如 pkg/handler），主程序仅负责路由注册和启动——这样更利于单元测试与解耦。
• ? httptest.NewRecorder() 模拟响应写入，httptest.NewRequest() 构造请求，二者配合可完全脱离网络进行端到端 handler 测试。

总结：Go 的测试机制简洁而严格——遵循 TestXxx(*testing.T) 命名约定、保持包一致性、移除冗余 main，即可让 go test 稳健运行。这是构建可维护 Go Web 服务的基础实践。