Windows下Apache多端口虚拟主机配置后8080端口报403错误

故障背景 #

本地环境使用Windows系统下的Apache搭建多端口站点映射：

• 80端口站点指向E:/htdocs，访问正常
• 计划将8080端口站点指向E:/Programming/Projects，已在httpd-vhosts.conf写入如下配置：

Listen 8080
<VirtualHost *:8080>
    ServerName localhost
    DocumentRoot "E:/Programming/Projects"
    <Directory "E:/Programming/Projects">
        AllowOverride All
    </Directory>
</VirtualHost>

• 故障表现：重启Apache服务后，localhost:80访问完全正常，访问localhost:8080始终返回403 Forbidden无权限提示，多次重启服务无改善。

分步排查修复 #

按出现概率从高到低排查即可快速定位问题：

• 最常见原因：Directory配置块缺失Apache层面的访问权限声明
  Apache 2.4及以上版本默认启用访问权限管控，未显式声明权限的目录会被直接拦截返回403。当前配置的<Directory>块仅设置了AllowOverride All规则，缺少核心权限放行语句，需要补充为：

  <Directory "E:/Programming/Projects">
      Require all granted
      AllowOverride All
  </Directory>
  

  如果使用的是Apache 2.2版本，替换为对应版本的权限语法：

  <Directory "E:/Programming/Projects">
      Order allow,deny
      Allow from all
      AllowOverride All
  </Directory>
  

  修改后保存配置，重启Apache即可验证。
• 排查Windows系统层面的目录权限限制
  右键E:/Programming/Projects目录打开「属性-安全」选项卡，确认Apache服务的运行账号（默认是SYSTEM账号，部分自定义安装包会使用普通本地账号）对该目录拥有「读取」「列出文件夹内容」的基础权限。如果权限列表中缺失对应账号的权限项，手动追加后再重启服务测试。
• 核对vhost配置的加载有效性
  打开Apache启动时的错误日志，确认8080端口的VirtualHost配置没有因为语法错误被跳过加载。同时检查httpd.conf中的全局<Directory />配置块，确认全局的访问限制规则没有拦截自定义站点目录的请求。
• 排查站点索引文件缺失问题
  检查E:/Programming/Projects根目录下是否存在Apache识别的默认索引文件（可通过httpd.conf中的DirectoryIndex配置项查看支持的文件列表，常见为index.html、index.php）。如果目录内没有匹配的索引文件、且未开启目录浏览权限，也会返回403报错。可以临时在目录中新建一个测试index.html文件，验证是否为索引文件缺失导致的问题。

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