Apache监听端口必须在httpd.conf中显式声明Listen指令，仅在httpd-vhosts.conf中配置*:8080无效；VirtualHost需配<Directory>权限块并设Require all granted；须启用Include conf/extra/httpd-vhosts.conf且重启服务。
Apache监听端口必须显式声明 Listen
不加 Listen 8080 这类语句，哪怕 httpd-vhosts.conf 里写了 *:8080，Apache 启动时也不会监听该端口，访问直接超时或拒绝连接。
操作上：打开 D:\xampp\apache\conf\httpd.conf，找到已有 Listen 80 行，在其下方新增你需要的端口，例如：
Listen 80 Listen 8080 Listen 8081 Listen 9000
注意点：
- 端口不能被其他进程占用（
netstat -ano | findstr :8080可查） - Windows 下避免使用 1–1023 的保留端口（如 80、443、21），尤其自动化脚本频繁启停时易触发系统权限限制
- 若改了非标准端口（比如 8080），所有测试用例里的 URL 必须同步更新为
http://localhost:8080/，否则 Selenium 或 Requests 请求会失败
httpd-vhosts.conf 中每个 VirtualHost 必须配 <Directory> 权限块
只写 DocumentRoot 和 ServerName 是不够的。Apache 2.4 默认拒绝所有目录访问，没配 <Directory> 就会返回 403 Forbidden。
正确写法示例（以端口 8080 为例）：
<VirtualHost *:8080>
DocumentRoot "D:/xampp/htdocs/testsite"
ServerName localhost
<Directory "D:/xampp/htdocs/testsite">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
关键细节：
-
Require all granted是 Apache 2.4 的写法，别写成旧版的Order allow,deny+Allow from all，否则启动报错 -
AllowOverride All才能让.htaccess生效，对 Laravel、ThinkPHP 等框架路由重写很关键 - 路径中的反斜杠
\在 Windows 下要统一换成正斜杠/，否则 Apache 解析失败
必须启用 httpd-vhosts.conf 的全局包含
默认情况下 httpd.conf 里这行是被注释掉的：
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
#Include conf/extra/httpd-vhosts.conf
如果不取消注释，你往 httpd-vhosts.conf 里加多少个 VirtualHost 都不会生效。
检查并修改为：
Include conf/extra/httpd-vhosts.conf
常见疏漏：
- 改完后忘记重启 Apache（仅重启控制面板里的服务不够，有时需手动 stop → start）
- 误删了
httpd-vhosts.conf开头的注释说明块，导致语法解析出错（其实不影响，但建议保留） - 多个
VirtualHost块之间没空行，某些版本 Apache 会把下一块识别为上一块的延续，造成配置错乱
自动化测试中端口冲突的真实来源常被误判
你以为是 Skype 或 IIS 占了 80？其实更可能是 Python 测试脚本本身在跑 flask.run(port=8080) 或 pytest --tb=short 启动了临时服务，没退出干净就去启 XAMPP，结果端口被占。
排查建议：
- 运行
netstat -ano | findstr :8080，记下 PID，再用tasklist | findstr <PID>查进程名 - CI/CD 脚本中若用
subprocess.Popen启动 XAMPP 控制台，记得加shell=True并捕获 stdout/stderr，否则后台进程残留难发现 - 本地调试时，浏览器标签页开着
http://localhost:8080，有时会“保持连接”，关掉所有标签再试
最麻烦的是 Windows Hyper-V 或 WSL2 默认启用 NAT 网关，会悄悄监听 53/80/443 端口——这时得进 PowerShell 执行 Get-NetTCPConnection -LocalPort 8080 | Format-List * 看 OwningProcess 是否为 svchost，再结合 Get-Process -Id <PID> 定位真实服务。
