nginx 的 auth_basic 本身不参与 tls 加密，仅在 http 层做 base64 编码传输与哈希密码比对，因此不会因 tls 算法不匹配导致校验失败；真实失败原因包括密码哈希格式错误、文件路径或权限问题、location 匹配失效、浏览器凭据缓存等。
Nginx 的 auth_basic 本身不涉及 TLS 加密算法匹配问题，它是在 HTTP 层做的明文 Base64 编码 + 服务端比对哈希密码的简单认证机制，全程不参与 SSL/TLS 握手、不协商 cipher suite、不校验证书、不依赖任何公钥算法（RSA/ECDSA）或签名算法（RSA-PSS/ECDSA-SHA256）。
所以，“由于加密算法不匹配导致 auth_basic 校验失败”这个前提不成立——auth_basic 不会因 TLS 层的 ECDHE、AES-GCM、SHA256 或 TLS 版本差异而校验失败。
但现实中，用户常把以下两类问题混淆，误以为是 “auth_basic 加密算法不匹配”：
✅ 真实可能被误判为“auth_basic 失败”的 TLS 层问题
这些发生在 auth_basic 之前，客户端根本没发到认证环节，就卡在了 HTTPS 握手阶段：
- 浏览器访问
https://site.com/admin/，页面空白或提示“无法安全连接” - curl 返回
curl: (35) error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure - Nginx error.log 出现
no shared cipher、no ciphers available、SSL_do_handshake() failed
? 这类错误和 auth_basic 无关，是 TLS 配置问题（如 cipher 套件太严、禁用了 TLSv1.2、证书签名算法不兼容等），需按 TLS 握手失败排查，不是 auth_basic 的锅。
✅ auth_basic 实际可能失败的真实原因（与加密算法无关）
| 问题类型 | 表现 | 排查要点 |
|---|---|---|
| 密码哈希格式错误 | 输入正确密码仍 401；Nginx 启动时报 invalid password hash
|
检查 .htpasswd 文件中密码是否用 openssl passwd -apr1 或 htpasswd -B 生成（推荐 -B 即 bcrypt）；避免用 openssl passwd 默认的 DES（已淘汰，仅 8 字符有效） |
| 文件路径或权限错误 | Nginx 启动失败或日志报 open() "/etc/nginx/.htpasswd" failed (13: Permission denied)
|
确保 .htpasswd 文件：由 nginx worker 进程用户（如 www-data 或 nginx）可读；路径在配置中写全且无拼写错误；无 BOM 或 Windows 换行符（用 file 和 dos2unix 检查） |
| location 匹配失效 | 访问 /admin/ 无弹窗，直接返回 200 或 404 |
检查 auth_basic 是否写在正确的 location 或 server 块内；注意正则 location 优先级；确认未被 satisfy any; 或 auth_request 覆盖 |
| 浏览器缓存凭据干扰 | 修改密码后仍能登录 | 清除浏览器保存的 Basic Auth 凭据（Chrome 地址栏点击锁图标 → “清除凭据”；或换隐身窗口测试） |
✅ 快速验证 auth_basic 是否真在工作
不用猜，用命令直击本质：
# 1. 模拟带凭据的请求（成功应返回 200） curl -u admin:123456 https://example.com/admin/ -I # 2. 模拟错误凭据（应返回 401） curl -u admin:wrongpass https://example.com/admin/ -I # 3. 不带凭据（应返回 401 + WWW-Authenticate 头） curl -I https://example.com/admin/
若第 3 条连 401 都没返回，说明 auth_basic 根本没生效（配置位置错 / 未 reload / 被其他指令覆盖）；
若第 1 条返回 401，检查 .htpasswd 中 admin 对应的哈希是否真的匹配 123456（可用 htpasswd -v .htpasswd admin 验证）。
不复杂但容易忽略。auth_basic 就是个“密码本比对”，它不加密传输、不协商算法、不验证证书——把它和 TLS 层问题分开看，问题就清晰了。
