如何用Golang Fiber框架加载环境变量-Golang-PHP中文网

os.getenv在fiber启动时可能拿不到环境变量，因fiber不处理加载，完全依赖go标准库；必须在fiber.new()和app.listen()前用godotenv.load()加载.env文件，并验证关键变量是否存在。

如何用golang fiber框架加载环境变量

为什么 `os.Getenv` 在 Fiber 启动时可能拿不到环境变量

因为 Fiber 本身不处理环境变量加载，它完全依赖 Go 标准库的 os.Getenv。如果你没在 main() 执行前加载好变量（比如 .env 文件），Fiber 路由或中间件里调用 os.Getenv("DB_URL") 就会返回空字符串——不是 Fiber 的 bug，是 Go 运行时根本没见过这个变量。

常见错误现象：os.Getenv("PORT") 返回空，导致 app.Listen(":3000") 实际监听 ":"，启动失败报错 listen tcp :: invalid port
正确时机：必须在 fiber.New() 和 app.Listen() 之前完成加载
推荐方案：用 github.com/joho/godotenv，轻量、无依赖、支持注释和多环境文件

如何用 `godotenv` 加载 .env 并验证是否生效

先安装：go get github.com/joho/godotenv。然后在 main.go 开头立即加载，别等 Fiber 初始化完再做：

package main

import (
  "log"
  "os"
  "github.com/gofiber/fiber/v2"
  "github.com/joho/godotenv"
)

func main() {
  // 必须放最前面！
  if err := godotenv.Load(); err != nil {
    log.Println("No .env file found, using system env only")
  }

  // 验证关键变量是否存在
  if os.Getenv("APP_ENV") == "" {
    log.Fatal("APP_ENV is required but not set")
  }

  app := fiber.New()
  // ...
}

默认加载当前目录下的 .env；如需指定路径，用 godotenv.Load(".config/.env")
如果想按环境加载不同文件（如 .env.development），先读 APP_ENV，再动态传入：godotenv.Load(".env." + env)
godotenv.Load() 不会覆盖已存在的系统环境变量，只补充缺失的——这点比盲目 os.Setenv 安全

Fiber 中安全读取环境变量的几种写法

别在 handler 里裸写 os.Getenv("SECRET_KEY")，容易漏判空值或类型转换出错。建议封装一层：

Colly Golang Web Scraper and Crawler Framework

Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。

下载

// config.go
func GetEnv(key, fallback string) string {
  if value := os.Getenv(key); value != "" {
    return value
  }
  return fallback
}

func GetEnvInt(key string, fallback int) int {
  if value := os.Getenv(key); value != "" {
    if i, err := strconv.Atoi(value); err == nil {
      return i
    }
  }
  return fallback
}

在 Fiber 中使用：port := GetEnvInt("PORT", 3000)，然后 app.Listen(":" + strconv.Itoa(port))
避免直接把 os.Getenv 结果传给 fiber.Config 字段，比如 fiber.Config{Prefork: os.Getenv("PREFORK") == "true"} —— 如果变量未设置，"false" 会被当成字符串，比较结果永远是 false
敏感变量（如数据库密码）建议在部署时通过系统环境注入，而不是塞进 .env 提交到 Git

常见陷阱：Windows 换行符、变量名大小写、加载顺序

.env 文件在 Windows 上用 CRLF 换行，godotenv 默认能处理；但如果你手动用 os.Setenv 或 shell 脚本加载，大小写就成问题了：

Linux/macOS 环境变量名区分大小写：DB_URL 和 db_url 是两个变量；Windows 不区分，但 Go 运行时在所有平台都按原样查键，所以统一用大写+下划线是稳妥做法
不要在 init() 函数里调用 godotenv.Load()：Go 的 init 执行顺序不可控，可能晚于其他包的变量初始化
如果用 Docker，.env 文件不会自动挂载进容器——得显式用 docker run --env-file .env 或在 docker-compose.yml 里写 env_file: [".env"]