Shopware 6：.htaccess认证在/admin端无效，输正确密码仍返回401

问题背景 #

已为Shopware 6应用配置Basic Auth：创建了包含用户名和哈希密码的.htpasswd文件，与public/.htaccess正确关联，前台验证弹窗正常且可通过，但访问/admin管理端时，输入正确密码仍反复弹出验证窗口并返回401错误。当前public/.htaccess配置如下：

AuthType Basic
AuthName "restricted area"
AuthUserFile /Path/to/MyDomainSecretDirectory/.htpasswd
require valid-user

可能的原因及解决方向 #

• Admin路由规则拦截了Basic Auth
  Shopware 6 Admin的路由由public/index.php统一处理，默认的.htaccess规则可能未将Basic Auth配置正确应用到/admin路径。可以尝试为/admin路径单独添加认证规则，在现有配置中追加：

  <Location "/admin">
      AuthType Basic
      AuthName "restricted area"
      AuthUserFile /Path/to/MyDomainSecretDirectory/.htpasswd
      require valid-user
  </Location>
  

• PHP环境未正确传递Auth凭证
  部分PHP运行环境（如CGI模式）会丢失Basic Auth的HTTP头信息，导致认证无法生效。在public/.htaccess中添加以下配置，强制传递Auth头：

  SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
  

• .htpasswd路径或权限问题
  前台能正常读取.htpasswd不代表Admin上下文下也能访问：

  1. 确认AuthUserFile的绝对路径在Admin请求的服务器上下文里是有效的，可替换为相对路径（相对于public目录，比如../.htpasswd，前提是.htpasswd放在public上级目录）；
  2. 检查.htpasswd文件的权限：确保运行Apache/PHP的系统用户（如www-data）有读取该文件的权限。

• Shopware Admin认证机制冲突
  Shopware Admin自带独立的账号认证系统，Basic Auth可能与它的会话管理冲突。可以尝试清除浏览器缓存和Cookie后重新验证，或者暂时禁用Admin的自动登录会话，测试Basic Auth是否能正常生效。

• 服务器全局配置限制
  检查服务器的虚拟主机配置或httpd.conf，确认/admin路径的AllowOverride设置为All或AuthConfig，否则.htaccess里的认证规则会被忽略。若无法修改全局配置，可将Basic Auth配置直接写入虚拟主机的<Directory>块中。

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