必须用app.ListenTLS,不能套http.ListenAndServeTLS;因* fiber.App不实现http.Handler接口,硬传会导致编译错误或panic;证书须为fullchain.pem、私钥未加密且权限0600、换行符为LF。

必须用 app.ListenTLS,不能套 http.ListenAndServeTLS;Fiber 的 *fiber.App 不是 http.Handler,硬传会编译失败或 panic。
为什么不能用 http.ListenAndServeTLS
常见错误写法:http.ListenAndServeTLS(":443", "cert.pem", "key.pem", app)。Go 编译器直接报错:cannot use app (type *fiber.App) as type http.Handler。Fiber v2/v3 都不实现标准库的 http.Handler 接口——它基于 fasthttp,底层协议栈和上下文模型完全不同。框架自己封装了 TLS 启动逻辑,app.ListenTLS 是唯一安全入口。
证书文件必须拼 fullchain.pem
Fiber 底层调用 tls.LoadX509KeyPair,该函数要求 certFile 参数必须包含完整证书链(域名证书 + 所有中间 CA 证书),否则 iOS、Java 客户端或部分浏览器握手失败,错误日志里只显示 tls: bad certificate 或 x509: certificate signed by unknown authority。
- Let’s Encrypt 用户:别只用
cert.pem,得合并:cat cert.pem chain.pem > fullchain.pem - 自签名调试:用
openssl req时必须加-addext "subjectAltName = DNS:yourdomain.com",否则 Chrome 90+ 拒绝连接 - 换行符必须是 LF:Windows CRLF 会导致
tls: failed to find any PEM data,用dos2unix fullchain.pem key.pem修复
私钥权限和加密状态很关键
Go 标准库 crypto/tls 不支持密码保护的私钥。如果用 openssl genrsa -aes256 生成,Fiber 启动时不会报错,但 TLS 握手阶段静默失败,日志可能只有 accept tcp: operation not permitted 或直接卡住。
- 解密命令:
openssl rsa -in key.pem.enc -out key.pem - Linux 上私钥权限必须是
0600,否则crypto/tls拒绝加载(无明确错误提示) - 不要把私钥放在可读目录下,避免被意外泄露
需要自定义 http.Server 字段怎么办
若要设置 ReadTimeout、WriteTimeout 或 IdleTimeout,不能靠 app.ListenTLS——它不暴露 http.Server 实例。得用 app.Listener 手动构造:
srv := &http.Server{
Addr: ":443",
Handler: app.Handler(),
ReadTimeout: 30 * time.Second,
WriteTimeout: 30 * time.Second,
IdleTimeout: 60 * time.Second,
}
ln, err := tls.Listen("tcp", srv.Addr, &tls.Config{
Certificates: []tls.Certificate{cert},
})
if err != nil {
log.Fatal(err)
}
log.Fatal(srv.Serve(ln))
注意:app.Handler() 返回的是兼容 http.Handler 的包装器,仅在此类高级定制场景才需手动接管 TLS 监听逻辑。日常部署优先走 app.ListenTLS,简单可靠。


















