Beego 启动 HTTPS 必须通过 app.conf 配置驱动，禁用手动调用 http.ListenAndServeTLS；需同时设置 EnableHTTPS=true 和 EnableHttpTLS=true，指定 HttpsPort、HTTPSCertFile（fullchain.pem）与 HTTPSKeyFile（未加密私钥），且证书链完整、路径正确、权限合规。
Beego 启动 HTTPS 必须通过 app.conf 配置启用，不能手动调用 http.ListenAndServeTLS —— 因为 Beego v2 的启动逻辑不暴露 http.Server 实例，也不接受外部 TLS 封装。
Beego 的 HTTPS 启用方式只有一种：配置文件驱动
Beego 不提供类似 Gin 的 RunTLS 方法，也不允许你把 beego.App 当作 http.Handler 传给标准库。它的 HTTPS 是纯配置式启动，由框架内部在 beego.Run() 阶段自动触发。
-
EnableHTTPS = true和EnableHttpTLS = true必须同时为true，缺一不可；后者控制是否启用 TLS 层，前者控制是否开启 HTTPS 监听入口 -
HttpsPort默认是443，但开发时建议先设为8443避免权限问题（Linux 下绑定 1–1023 端口需 root） -
HTTPSCertFile和HTTPSKeyFile必须是相对路径（相对于可执行文件所在目录），且文件必须存在、可读 - 若使用 Let’s Encrypt 证书，
HTTPSCertFile必须填fullchain.pem（不是cert.pem），否则客户端会报NET::ERR_CERT_AUTHORITY_INVALID
证书文件常见错误直接导致启动失败
Beego 启动时不会校验证书内容，但底层调用 tls.LoadX509KeyPair，一旦失败就 panic 并退出，错误信息往往很简短，比如 tls: failed to find any PEM data 或 private key does not match public key。
- 换行符必须是 LF（Unix 风格），Windows 的 CRLF 会导致解析失败；可用
dos2unix server.crt server.key修复 - 私钥不能加密：如果用
openssl genrsa -aes256生成，必须先解密，否则 Beego 会在 TLS handshake 阶段卡住，无明确报错 - 证书与私钥不匹配是最隐蔽的坑——常见于百度云/腾讯云下载后误用
.cer替代.crt；正确做法是把.cer（CA 中间证书）和.crt（站点证书）拼成一个文件：cat xxx.cer xxx.crt > fullchain.pem，再设为HTTPSCertFile - 自签名证书调试时，
openssl req必须加-addext "subjectAltName = DNS:localhost,IP:127.0.0.1"，否则 Chrome 90+ 拒绝连接，报ERR_CERT_COMMON_NAME_INVALID
Beego v2 的 TLS 行为无法定制
Beego v2 的 HTTPS 启动完全封装，不暴露 *http.Server 实例，因此你无法：
- 设置
TLSConfig.MinVersion（例如强制 TLS 1.2+） - 启用双向 TLS（mTLS）
- 自定义
GetCertificate或VerifyPeerCertificate - 禁用特定密码套件或启用 ALPN
如果你需要这些能力，只能退回到原生 http.Server + beego.BeeApp.Handlers（即把 Beego 路由注册为 handler），自己调用 http.ListenAndServeTLS。但这意味着放弃 Beego 的自动启动流程，也绕过了所有 app.conf 中的 HTTPS 相关配置项。
安全组与本地调试的端口陷阱
线上部署时，即使 Beego 启动成功，HTTPS 仍不可访问，大概率是基础设施层拦截了流量：
- 云服务器（如阿里云、腾讯云）的安全组必须放行
HttpsPort对应的端口（默认 443），仅开放 80 不够 - 本地开发用
HttpsPort = 8443时，浏览器访问地址必须写全：https://localhost:8443，漏掉:8443会 fallback 到 443，连接拒绝 - Docker 容器内运行 Beego 时，宿主机映射端口要显式声明：-p 8443:8443，且容器内
app.conf的HttpsPort必须与映射目标一致
证书链完整性、私钥权限（Linux 上建议 chmod 0600 server.key）、路径拼写错误——这三者占 Beego HTTPS 启动失败原因的 80% 以上，检查顺序建议按此优先级来。
