Apache在Windows环境下基础认证失败问题求助

相关配置信息 #

.htaccess 内容 #

AuthName "Restricted Area" 
AuthType Basic 
AuthUserFile path/.htpasswd
require valid-user

.htpasswd 内容 #

test:FUgb1Qdh6571o
# 该密码文件由密码生成工具创建

问题现象 #

在Windows 10系统上运行Apache时，访问目标文件夹会弹出认证对话框，但无法完成认证以访问受限文件夹。

Apache错误日志信息：

AH01617: user test: authentication failure for "/folder": Password Mismatch

相同配置在Ubuntu系统上的Apache可正常工作，请问问题出在哪里？是否是密码存储方式不同导致的？

问题原因及解决方法 #

确实是密码存储方式的兼容性问题导致的：

• 你当前.htpasswd里的密码哈希是基于Unix系统的传统crypt算法，而Windows版Apache默认不支持这种哈希格式（Windows系统本身没有对应的crypt函数实现）。
• Ubuntu下的Apache默认支持crypt算法，所以能正常验证通过。

解决步骤 #

1. 用Apache自带工具生成兼容密码
   找到Windows版Apache安装目录下bin文件夹里的htpasswd.exe（比如C:\Apache24\bin\htpasswd.exe），打开命令提示符执行：

   htpasswd -c 你的绝对路径/.htpasswd test
   

   按照提示输入密码，工具会生成Windows Apache支持的MD5格式哈希（默认）。
2. 替换旧的.htpasswd文件
   把新生成的密码文件内容替换掉原来的，同时确保AuthUserFile配置的是Windows系统的绝对路径（比如AuthUserFile C:/Apache24/htdocs/your-folder/.htpasswd，用正斜杠或者转义反斜杠）。
3. 检查路径正确性
   Windows下尽量避免用相对路径配置AuthUserFile，绝对路径能减少文件找不到的概率，这也是容易忽略的排查点。

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