Beego启用HTTPS必须同时设置EnableHTTPS=true和EnableHttpTLS=true，缺一不可；否则服务仅监听HTTP端口，curl -I https://localhost:443将返回connection refused。
Beego启用HTTPS必须同时设置 EnableHTTPS = true 和 EnableHttpTLS = true，缺一不可；否则服务只监听HTTP端口，curl -I https://localhost:443 会直接返回 connection refused。
两个开关必须同时开启
Beego的HTTPS不是靠单个配置项触发的。EnableHTTPS 控制是否启用HTTPS监听逻辑，EnableHttpTLS 控制是否调用 http.ListenAndServeTLS。两者缺一，服务就退化为纯HTTP。
-
EnableHTTPS = true但EnableHttpTLS = false→ 启动不报错，但无TLS监听 -
EnableHttpTLS = true但EnableHTTPS = false→ 启动时 panic：找不到HttpsPort配置 - 正确写法必须是二者都为
true，且HttpsPort显式设为整数（不能带引号）
证书和私钥格式必须严格符合要求
Beego底层调用 Go 标准库的 http.ListenAndServeTLS，只接受无密码、PEM 格式的私钥和证书。常见错误包括：
- 私钥以
-----BEGIN ENCRYPTED PRIVATE KEY-----开头 → 启动报错：tls: failed to find any PEM data in key input - 证书是
.pfx或.p12→ 必须用 OpenSSL 解包：openssl pkcs12 -in cert.pfx -nocerts -nodes -out server.keyopenssl pkcs12 -in cert.pfx -clcerts -nokeys -out server.crt - 私钥开头应为
-----BEGIN RSA PRIVATE KEY-----或-----BEGIN EC PRIVATE KEY----- - 证书路径是相对于可执行文件所在目录，不是
conf/app.conf所在位置
与 Nginx 共存时必须禁用 Beego 的 HTTPS
如果 Beego 前面有 Nginx 做 SSL 终止（即 Nginx 处理 443 端口和证书），Beego 本身必须关掉 HTTPS，否则会出现协议错配：
- Nginx 把解密后的 HTTP 请求转发给 Beego 的
HttpPort（如 8080） - 但 Beego 若仍启用
EnableHTTPS，它会尝试对明文再套 TLS → 连接中断 - 典型现象：
curl -k https://example.com返回空响应或502 Bad Gateway，Nginx error.log 显示upstream prematurely closed connection - 正确做法：Nginx 配置 SSL，Beego 中设
EnableHTTPS = false、EnableHttpTLS = false，只保留HttpPort = 8080
开发阶段用自签名证书要绕过客户端校验
Beego 不校验自己的证书，但浏览器、curl、Postman、前端 fetch 会拒绝连接。调试时需主动忽略：
-
curl -k https://localhost:443（-k跳过证书验证） - Chrome 访问时点「高级」→「继续前往」（仅限本地）
- Node.js 客户端需设
process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0'（仅开发） - 注意：不能把
-k或环境变量带到生产环境
最容易被忽略的是证书路径的相对基准 —— 它始终以 Beego 可执行文件（如 myapp.exe 或 ./myapp）所在目录为准，不是 conf/ 目录，也不是当前工作目录。哪怕你从别处 cd 进来运行，路径解析也只认二进制文件位置。
