XAMPP需显式添加Listen指令（如Listen 8080）并配置对应VirtualHost及Require all granted，再放行防火墙端口，否则局域网设备访问会因连接拒绝或403错误失败。
XAMPP 默认只监听 80 端口，不配置就无法通过局域网 IP + 其他端口（如 8080、3000）被外部设备（手机、测试机、前端项目）调用 API —— 这不是权限问题，是 Apache 根本没在听那个端口。
修改 httpd.conf 添加监听端口
Apache 必须明确知道“我在哪些端口上等请求”，否则即使你浏览器访问 http://192.168.1.100:8080，连接也会直接被拒绝（ERR_CONNECTION_REFUSED）。
- 打开
D:\xampp\apache\conf\httpd.conf（Windows）或/opt/lampp/etc/httpd.conf（Linux/macOS） - 搜索
Listen 80，在其下方新增你要的端口，例如：Listen 80<br>Listen 8080<br>Listen 3001
- 不要删掉
Listen 80，否则本地localhost会失效 - 避免使用
1024以下端口（如80、443、21），非 root 用户在 Linux/macOS 下可能无法绑定
为每个端口配独立 <virtualhost></virtualhost> 并设目录权限
只加 Listen 不够。Apache 收到 :8080 的请求后，得知道该交给哪个项目处理；而且默认仍只允许本机访问，外网调用会卡在 403 Forbidden。
XAMPP 8.0.30
下载
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
- 确保
httpd.conf中这行已取消注释：Include conf/extra/httpd-vhosts.conf
- 编辑
conf/extra/httpd-vhosts.conf，添加类似结构：<VirtualHost *:8080><br> ServerName localhost<br> DocumentRoot "D:/xampp/htdocs/api-v1"<br> <Directory "D:/xampp/htdocs/api-v1"><br> Require all granted<br> AllowOverride All<br> </Directory><br></VirtualHost>
-
Require all granted是关键：没有它，Android/iOS/前端项目从局域网 IP 访问时必报403 -
DocumentRoot路径必须是绝对路径，且不能以斜杠结尾（"D:/xampp/htdocs/api-v1/"❌）
防火墙和系统级拦截必须放行
即使 Apache 配好了，Windows Defender、macOS 防火墙或 Linux iptables 仍会把外部对 8080 等端口的请求直接丢弃。
- Windows：进「Windows Defender 防火墙 → 高级设置 → 入站规则」，新建规则，协议类型选「TCP」，端口填
8080,3001（逗号分隔），操作选「允许连接」 - macOS：「系统设置 → 网络 → 防火墙 → 防火墙选项」，勾选「启用防火墙」后点击「+」，添加
httpd进程或手动放行端口 - Linux（如 Ubuntu）：
sudo ufw allow 8080<br>sudo ufw allow 3001
- 重启 Apache 后，用另一台设备浏览器访问
http://[你的局域网IP]:8080，能返回页面才算真正通了
调试时最容易忽略的三个点
很多问题不是配错，而是漏掉这些隐性环节：
- Android/iOS App 调用时，
http://localhost:8080永远不通——必须用电脑的局域网 IP（如http://192.168.1.100:8080），且确认手机和电脑在同一 Wi-Fi 下 - Chrome 浏览器有时会缓存 301 重定向，改完配置后建议用无痕窗口或
curl -v http://192.168.1.100:8080验证 - 如果用 PHP 写 API，记得检查
php.ini中display_errors = On和error_reporting = E_ALL，否则 JSON 返回空或 500 错误却看不到报错信息
