app.Listen()参数必须是字符串格式的地址，如":3000"；传入整数会编译失败，环境变量需拼接冒号，错误须显式处理，监听地址须确认绑定到0.0.0.0或通配符。
app.Listen()参数必须是字符串格式的地址
Fiber 的 app.Listen() 不接受整数端口（比如 3000），传入数字会编译失败或 panic。常见错误写法：app.Listen(3000) → 报错 cannot use 3000 (type int) as type string。
正确做法是把端口拼成完整监听地址字符串，例如：app.Listen(":3000")、app.Listen("0.0.0.0:8080")、app.Listen("[::1]:3000")。
-
":3000"是最推荐写法：绑定所有可用网卡 + 自动兼容 IPv4/IPv6 -
"0.0.0.0:3000"强制 IPv4，某些云平台会警告“未启用 IPv6” -
"localhost:3000"或"127.0.0.1:3000"仅限本机回环，Docker 容器内、ngrok 穿透、远程 curl 全部失败
环境变量传端口时要小心类型转换
很多项目用 os.Getenv("PORT") 动态读取端口，但返回的是字符串，需确保它被正确拼入监听地址 —— 不能直接当整数用，也不能漏掉冒号。
错误示例：port := os.Getenv("PORT"); app.Listen(port) 看似合理，但如果 PORT=3000，结果就是 app.Listen("3000")，这会被解析为 Unix domain socket 路径，不是 TCP 端口，启动报错 listen tcp: address 3000: missing port in address。
- ✅ 正确拼接：
port := os.Getenv("PORT"); app.Listen(":" + port) - ✅ 更健壮写法：
port := os.Getenv("PORT"); if port == "" { port = "3000" }; app.Listen(":" + port) - ⚠️ 注意空格：如果环境变量含前后空格（如
PORT=" 3000 "），要用strings.TrimSpace清理
端口被占用或权限不足时错误不明显
app.Listen() 返回 error，但很多人忽略它，导致服务静默退出，只看到进程闪退或 exit status 1，根本看不出是端口问题。
- 开发阶段建议直接
log.Fatal(app.Listen(":3000"))，让错误立刻暴露 - 生产环境应分类处理：
errors.Is(err, syscall.EADDRINUSE)提示端口已被占；strings.Contains(err.Error(), "permission denied")说明非 root 用户尝试绑定 1–1023 端口（如:80） - 别把
app.Listen()放进 goroutine：Fiber 内部已做阻塞处理，额外起协程会让 panic 无法被捕获，日志丢失关键上下文
HTTPS 和 Unix Socket 的端口配置逻辑不同
HTTPS 不是“换端口就行”，而是完全不同的监听方式；Unix Socket 甚至不走 TCP/IP 协议栈，所以不能用 ":3000" 这类写法。
- HTTPS 必须用
app.ListenTLS(":443", "cert.pem", "key.pem")，不是app.Listen(":443")+ 手动套 TLS - Unix Socket 用
app.ListenUnix("/tmp/fiber.sock", fiber.UnixListenerMode(0666))，注意权限掩码是八进制字面量，写成666（十进制）会导致 nginx 反代失败 - HTTP/2 在 Fiber v3 中仅当调用
ListenTLS且 Go ≥ 1.24 时自动启用，无需额外开关
":3000"，也要进容器或服务器执行 netstat -tuln | grep :3000 确认输出里是 *:3000，而不是 127.0.0.1:3000 —— 后者意味着外部请求永远到不了你的 Fiber 应用。 
