监听地址写成"localhost:3000"会导致连接失败，因其解析为IPv6的::1而忽略IPv4的127.0.0.1，且仅响应本机loopback接口；正确做法是使用通配地址":3000"以兼容IPv4/IPv6并确保本地及容器内均可访问。
监听地址写成 "localhost:3000" 就连不上？
这是最常踩的坑：Fiber 启动时若监听 "localhost:3000"，在 macOS、Docker 容器或某些 Linux 网络栈下，curl http://127.0.0.1:3000 或前端 fetch 会失败——因为 localhost 解析为 IPv6 地址 ::1，而 127.0.0.1 是 IPv4，二者不互通。更糟的是，部分环境里 localhost 绑定只响应本机 loopback 接口，外部不可达。
正确做法是用通配地址：":3000"（即所有网卡 + 所有协议栈）。
- ✅ 推荐：
app.Listen(":3000")—— 兼容 IPv4/IPv6，本地和容器内 curl、浏览器、Postman 都能通 - ⚠️ 谨慎：
app.Listen("0.0.0.0:3000")—— 强制 IPv4，丢弃 IPv6 请求，某些云环境会警告 - ❌ 避免：
app.Listen("localhost:3000")或"127.0.0.1:3000"—— 限制访问范围，调试时易误判服务没起来
app.Listen() 返回错误却没处理？
app.Listen() 是阻塞调用，但返回 error；如果忽略它，进程可能静默退出，日志里只看到 “exit status 1”，根本看不出是端口被占还是 TLS 配置错。
必须显式检查错误，尤其上线前：
立即学习“go语言免费学习笔记（深入）”；
- 用
log.Fatal(app.Listen(":3000"))快速暴露问题（开发/测试够用） - 生产环境建议捕获并分类处理：
if errors.Is(err, syscall.EADDRINUSE)提示端口占用；strings.Contains(err.Error(), "permission denied")提示非 root 用户尝试绑定 1–1023 端口 - 别把
app.Listen()放进 goroutine —— Fiber 内部已做并发处理，额外起 goroutine 反而让 panic 无法被捕获
想用 HTTPS 或 Unix Socket 怎么配？
Fiber 的 app.Listen() 原生支持 HTTPS 和 Unix domain socket，但参数格式和 net/http 不同，容易传错类型。
- HTTPS：传入
tls.Config指针，不是证书路径字符串app.ListenTLS(":443", "cert.pem", "key.pem")✅（自动加载）app.Listen(":443", tlsConfig)✅（自定义 config）app.ListenTLS(":443", "fullchain.pem", "privkey.pem")✅（Let’s Encrypt 标准路径） - Unix Socket：
app.ListenUnix("/tmp/fiber.sock", fiber.UnixListenerMode(0666))✅
注意权限掩码是八进制字面量，别写成666（十进制）——那会变成01222，导致 nginx 反代连不上 - HTTP/2：仅当使用
ListenTLS且 Go 版本 ≥ 1.24 时自动启用，无需额外配置
多核 CPU 下怎么真正压满性能？
默认单进程模型在 4 核以上机器上只能跑满一个核心。Fiber 提供 Prefork 配置，但开启后有几个硬约束必须对齐：
- 必须用
fiber.New(&fiber.Config{Prefork: true})初始化，fiber.Default()不支持 Prefork - 子进程共享监听套接字，所以不能在 handler 里用全局变量缓存状态（比如计数器），会被各进程各自维护一份
- 日志必须用线程安全方式输出（如
log.SetOutput(os.Stderr)），否则多进程写同一文件会乱序或丢行 - 启动时会 fork 出
runtime.NumCPU()个进程，每个都打印一次 “Server is running”，别误以为重复启动了
Prefork 不是银弹：它提升吞吐上限，但也会让调试变难（gdb attach 多个进程）、内存占用翻倍，小项目没必要开。
