NGINX提示.htpasswd中用户不存在的问题求助

针对你遇到的Nginx持续要求输入密码、日志提示用户未找到的问题，可按以下思路排查：

• 检查文件权限与访问权限
  Nginx运行进程（通常为nginx或www-data用户）需要具备读取.htpasswd文件的权限。执行以下命令确保权限正确：

  # 设置文件可读权限
  chmod 644 /etc/nginx/conf/.htpasswd
  # 确保父目录权限允许访问
  chmod 755 /etc/nginx/conf
  

  同时可通过ls -l /etc/nginx/conf/.htpasswd查看文件所属用户/组，确保Nginx进程用户有读权限。

• 排查文件内容的隐藏字符
  确认.htpasswd中用户名/密码行没有隐藏空格、换行或特殊字符。使用cat -A /etc/nginx/conf/.htpasswd查看文件，每行结尾应显示$，无多余字符。如果存在异常字符，手动编辑清理或重新生成文件。

• 避免使用明文密码格式
  Nginx对{PLAIN}明文密码的支持存在兼容性问题（部分版本需特殊编译参数），建议使用htpasswd工具生成标准哈希格式的密码：

  # 安装htpasswd（若未安装）
  apt install apache2-utils  # Debian/Ubuntu
  yum install httpd-tools     # CentOS/RHEL
  # 生成用户密码（替换Carmina为目标用户名）
  htpasswd /etc/nginx/conf/.htpasswd Carmina
  

  生成后替换原文件中对应行，确保密码格式为crypt或SHA-1哈希（无需手动添加前缀）。

• 使用绝对路径指定密码文件
  配置中auth_basic_user_file conf/.htpasswd为相对路径，可能因Nginx工作目录导致解析错误。改为绝对路径：

  auth_basic_user_file /etc/nginx/conf/.htpasswd;
  

  修改后执行nginx -s reload重载配置。

• 验证配置重载与SELinux限制

  1. 每次修改配置后必须执行nginx -s reload确保生效，可先通过nginx -t验证配置语法是否正确。
  2. 若系统开启SELinux，可能阻止Nginx读取文件，临时关闭测试：

     setenforce 0
     

     若问题解决，需设置正确的SELinux上下文：

     chcon -R -t httpd_sys_content_t /etc/nginx/conf/.htpasswd
     

内容的提问来源于stack exchange，提问作者Nicola Scionti