go 中测试 `net/http` 服务需避免在测试文件中定义 `main()` 函数，应使用以 `test` 开头的函数，并确保测试文件与主代码同属 `package main`，且不引入包名冲突。
在 Go 项目中（如名为 beacon 的 Web 应用），常见的测试错误源于对 Go 测试机制的误解：测试文件不是可执行程序，而是由 go test 工具驱动的测试套件。因此，beacon_test.go 中绝不能包含 func main() —— 这会与 beacon.go 中的 main() 冲突，导致编译失败（main redeclared）；同时，测试文件也必须与源文件处于同一包（通常是 package main），否则会触发 found packages main and xxx 错误。
✅ 正确做法如下：
- 保持包声明一致：beacon.go 和 beacon_test.go 都应以 package main 开头；
- 使用标准测试函数签名：测试函数名必须以大写 Test 开头，接收 *testing.T 参数；
- 利用 net/http/httptest 模拟请求：无需启动真实服务器，即可完整验证 HTTP 处理逻辑。
例如，假设 beacon.go 包含一个简单 HTTP 处理器：
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
// beacon.go
package main
import (
"fmt"
"net/http"
)
func handler(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "OK")
}
func main() {
http.HandleFunc("/", handler)
http.ListenAndServe(":8080", nil)
}对应的标准测试应写为：
// beacon_test.go
package main
import (
"net/http"
"net/http/httptest"
"testing"
)
func TestHandler(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)
}
if w.Body.String() != "OK" {
t.Errorf("expected body 'OK'; got %q", w.Body.String())
}
}⚠️ 注意事项：
- 不要删除或修改 package main —— 测试文件必须与被测代码同包，才能访问未导出的函数（如本例中的 handler）；
- go test 默认只运行当前目录下 *_test.go 中的 TestXXX 函数，无需 main() 入口；
- 若需测试 main() 启动逻辑（如命令行参数、服务初始化），建议将核心逻辑拆分为可测试函数，而非直接测试 main()；
- 使用 go test -v 查看详细输出，go test -cover 检查测试覆盖率。
遵循以上结构，即可安全、高效地为 Go Web 应用编写可维护的 HTTP 单元测试。
