能go run main.go启动并返回HTTP 200即环境验证通过;报错主因是未在module目录执行go get -u或残留GOPATH模式,应先go mod init再go mod tidy拉取依赖,禁用go get手动安装。

能 go run main.go 启动且返回 HTTP 200,就是环境验证通过——不需要额外工具或命令。
为什么不用 go get -u 就报错?
常见错误是执行了 go get -u github.com/gofiber/fiber/v2 但没进 module 目录,或 GOPATH 模式残留。Fiber v2/v3 都要求项目在 Go Module 下运行。
- 检查当前目录是否有
go.mod:没有就先go mod init example.com/app - 如果已有
go.mod,但go run main.go报cannot find package "github.com/gofiber/fiber/v2",说明依赖没下载,运行go mod tidy - 别用
go get手动拉包——它可能写错版本(比如拉到 v1 或无版本后缀的分支),go mod tidy才是唯一可信的同步方式
最简验证代码必须包含什么?
三行足够,不加中间件、不配端口、不连 DB。重点是跑通框架生命周期:
package main
import "github.com/gofiber/fiber/v2"
func main() {
app := fiber.New() // 不要用 fiber.Default()
app.Get("/", func(c fiber.Ctx) error {
return c.SendString("ok")
})
app.Listen(":3000")
}
- 访问
curl -i http://localhost:3000/,看到HTTP/1.1 200 OK和ok就成功 - 如果卡住或报
address already in use,说明端口被占,换:3001即可 - 若 panic 提示
fiber: invalid port,是因为传了空字符串或非数字,确保Listen参数是":3000"这种格式
Windows/macOS/Linux 交叉编译前要关 CGO
本地验证通过 ≠ 生产能跑。很多线上 panic 来自证书池加载失败,根源是 CGO 开着却没目标系统 libc:
- Linux 部署:运行
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o server main.go - macOS M1/M2:用
GOARCH=arm64,别用amd64 - 构建后直接
./server启动,再 curl 测试——这步漏掉,等于没验环境
真正容易被忽略的是:验证时用的 go run 默认启用 CGO,而生产二进制往往禁用它。不提前用 CGO_ENABLED=0 go run main.go 过一遍,上线第一秒就可能 panic “failed to load system cert pool”。











