不建议在生产环境使用 ssl_verify_client optional，因其允许客户端不提供证书或验证失败仍继续连接，导致后端无法可靠区分认证状态、易引发逻辑混乱与安全盲区；应改用显式路由分离（如 /api/cert/ 配置 on 强制验签，普通路径保持单向 HTTPS）并由后端严格校验 X-Client-Verify: SUCCESS 头。
不建议在生产环境使用 ssl_verify_client optional 实现“自选单向或双向认证”。它不是灵活的降级机制，而是 TLS 协议层的宽松握手策略，存在安全盲区和逻辑不可控风险。
ssl_verify_client optional 的真实行为
该配置表示：Nginx 在 TLS 握手阶段允许客户端不提供证书，若提供了则尝试验证（需同时配置 ssl_client_certificate），但验证失败也不阻断连接。关键点在于：
- 它不区分“用户主动跳过”和“客户端根本没能力发证”，后端无法据此判断用户意图
- 验证失败时
$ssl_client_verify为FAILED，但连接仍继续，后端收不到明确拒绝信号 - 浏览器对子资源（CSS/JS/图片）默认不发证书，即使主页面用了 optional，静态资源请求也大概率以无证状态到达，造成后端逻辑混乱
代码层无法可靠实现“降级控制”的原因
所谓“降级”，隐含前提是后端能清晰识别当前请求是“已通过双向认证”还是“降级为单向”。但 optional 下：
-
$ssl_client_verify可能为SUCCESS、FAILED或空字符串，三者语义混杂：空值可能是未提供证书，也可能是 Nginx 验证流程未触发（如 SNI 不匹配） -
$ssl_client_s_dn在无证或验证失败时为空或不可信，不能作为身份依据 - 没有标准 HTTP 状态码或头字段标记本次请求是否“本应双向却降级”，后端只能靠猜测做分支，易被绕过
更合理的技术路径：显式路由分离 + 后端策略决策
若确实需要兼容两类客户端（如部分内网终端预装证书、部分外部用户仅走 HTTPS），应放弃在 TLS 层模糊处理，改用清晰分层设计：
- 前端入口统一走单向 HTTPS（如
/login），由后端判断是否支持并重定向至证书登录页（如/login/cert） - 为证书通道单独配置
ssl_verify_client on的 location 块（如location /api/cert/），确保该路径下强制验签、失败即拒 - 普通 API 路径（如
/api/v1/）保持单向 HTTPS，配合 Token 或 Session 鉴权，不依赖 TLS 层证书状态 - 后端收到请求后，只信任
X-SSL-Client-Verify: SUCCESS头（由 Nginx 显式透传），其余情况一律视为无证书上下文，不尝试“降级解析”
如果必须保留 optional 配置，请至少做到
仅限灰度或内部调试场景，并强制补充边界控制：
- 在 server 块中添加：
error_page 495 496 = @no_cert;，并在@no_cert中返回明确提示或跳转，避免静默降级 - 透传变量时加判空：
proxy_set_header X-Client-Verify $ssl_client_verify;，后端必须校验该 header 值严格等于SUCCESS才启用证书相关逻辑 - 禁用所有依赖 DN 字段的自动路由（如按
$ssl_client_s_dn_cn分发），此类字段在 optional 下无业务可信度
