SSLProxyEngine on是前提条件，因Apache默认不支持出站HTTPS客户端行为；不开则ProxyPass指向HTTPS后端时协议层失效，必然报502及SSL handshake failed。
SSLProxyEngine 必须开启，否则 Apache 根本无法作为 HTTPS 客户端连接后端，502 和 SSL handshake failed 是必然结果。
为什么 SSLProxyEngine on 不是可选项而是前提条件
Apache 的 SSLEngine on 只管自己对外提供 HTTPS；而代理到 https://backend:8443 时，它得主动发起 TLS 握手——这属于「出站 HTTPS 客户端行为」，由 mod_ssl 中独立的 SSLProxyEngine 控制。没开它，ProxyPass /api https://backend:8443 这行配置在协议层就失效，Apache 会试图用明文 TCP 连 443 端口，对方直接拒绝。
- 错误日志里出现
SSL Proxy requested for backend:8443 but SSLProxyEngine is not enabled就是明确提示 - 即使后端证书有效、路径写对、模块已加载，不开
SSLProxyEngine也 100% 失败 - 它必须放在
<VirtualHost>或<Location>块内，全局配置无效
SSLProxyVerify 和 SSLProxyCACertificateFile 怎么配才不掉链路
开启 SSLProxyEngine 后，默认会校验后端证书，但若后端用的是私有 CA、自签名或内网证书，Apache 因找不到信任根而中断连接，报 unable to get local issuer certificate。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
-
SSLProxyVerify none能绕过校验（调试可用），但生产环境等同于裸奔，不推荐 - 正确做法是：用
SSLProxyCACertificateFile /path/to/internal-ca-bundle.crt显式指定信任的根+中间证书 PEM 文件 - 若需严格校验（如金融场景），设
SSLProxyVerify require并确保SSLProxyCACertificateFile包含完整可信链 - 注意：该 PEM 文件权限应为
644，且路径不能被 Web 可读（避免泄露 CA）
透传客户端证书给后端时，SSLProxyMachineCertificateFile 的关键细节
当后端要求双向 TLS（mTLS），Apache 需携带自己的客户端证书去认证。这不是简单把证书丢过去就行。
-
SSLProxyMachineCertificateFile必须指向含私钥的 PEM 文件（证书+密钥合并或密钥单独用SSLProxyMachineCertificateKeyFile指定） - 私钥不能加密（即无密码保护），否则 Apache 启动时卡住，日志报
SSLProxyMachineCertificateFile: key file contains encrypted private key - 若后端校验证书域名，还需加
SSLProxyCheckPeerCN off或确保证书 SAN 匹配ProxyPass目标域名 - 别忘了
ProxyPreserveHost on，否则后端看到的Host头是后端地址而非原始请求域名
全链路加密下容易被忽略的头传递与协议一致性
前端 HTTPS + 后端 HTTPS 不等于安全闭环。如果后端应用依赖 X-Forwarded-Proto 判断原始协议，而 Apache 没传或传错，重定向就会跳到 http://，导致混合内容或无限跳转。
- 必须显式设置：
RequestHeader set X-Forwarded-Proto "https"和RequestHeader set X-Forwarded-Port "443" - 后端 Java/Spring Boot/Tomcat 等需主动信任这些头，仅靠
ProxyPreserveHost不够 - 若后端监听非标准 HTTPS 端口（如
:8443），ProxyPassReverse必须带端口，否则重定向 Location 里的路径会被 Apache 错误重写 - 最后检查响应头：确认
X-Forwarded-Proto: https出现在请求到达后端前，且后端生成的Location是https://开头
