使用ErrorDocument 401时.htaccess密码保护失效问题求助

这种情况我之前帮朋友排查过类似的，咱们一步步拆解问题，大概率是路径配置、目录索引或者Apache权限设置的问题，具体可以从这几个方向入手：

1. 确认AuthUserFile的绝对路径是否正确 #

你在.htaccess里写的"/demo/.htpasswd"很可能不是服务器的系统绝对路径——Apache需要知道文件在服务器硬盘上的真实位置，而不是网站根目录的相对路径。

比如如果你的网站根目录是/var/www/html，那.htpasswd的真实路径应该是/var/www/html/demo/.htpasswd。你可以通过SSH登录服务器，在终端执行以下命令获取真实路径：

realpath /demo/.htpasswd

把得到的结果替换到.htaccess的AuthUserFile后面，比如：

AuthUserFile "/var/www/html/demo/.htpasswd"

2. 检查目标目录是否有默认索引文件 #

登录验证通过后，Apache会尝试加载/demo/fb/目录下的默认索引页（比如index.html、index.php），如果这个目录里没有任何索引文件，就会返回404。

解决方法有两个：

• 在/demo/fb/目录里上传一个索引文件（比如新建一个简单的index.html测试页）
• 在.htaccess里添加DirectoryIndex指令，指定允许的索引文件名，比如：

  DirectoryIndex index.php index.html index.htm
  

3. 确保Apache允许.htaccess覆盖配置 #

如果你的Apache主配置（httpd.conf）或者虚拟主机配置里，/demo/fb/所在的目录设置了AllowOverride None，那么.htaccess里的验证指令可能生效了，但后续的目录访问规则被限制，导致404。

你需要找到对应目录的配置块，把AllowOverride改成All或者至少AuthConfig（因为用到了认证相关指令）：

<Directory "/var/www/html/demo/fb">
    AllowOverride All
    Require all granted
</Directory>

修改后记得重启Apache服务：

# Ubuntu/Debian系统
sudo systemctl restart apache2
# CentOS/RHEL系统
sudo systemctl restart httpd

4. 验证.htpasswd的密码哈希格式是否正确 #

虽然你能弹出登录窗，但如果密码哈希格式不正确，可能会出现“验证通过但跳转异常”的情况。确保你的密码是用htpasswd命令生成的，而不是手动编写的。比如重新生成密码：

htpasswd -m /demo/.htpasswd admin

执行后输入新密码，会自动生成正确的MD5格式哈希，替换掉原来的内容。

5. 临时排查ErrorDocument配置的干扰 #

你设置的ErrorDocument 401 "Authorisation Required"是字符串提示，本身没问题，但可以暂时注释掉这条指令测试一下，看是否能正常访问（排除这条配置意外干扰的可能）。

内容的提问来源于stack exchange，提问作者Ankita Kashyap