本文教你如何将本地 laravel 开发服务器绑定到局域网可见的 ipv4 地址（如 192.168.2.222），使同一 wifi 下的其他设备能直接访问并测试你的 api，解决“connection refused”或“unable to connect”等常见错误。

默认情况下，php artisan serve 仅监听 127.0.0.1（即 localhost），这意味着它拒绝来自外部设备（如另一台 PC 或手机）的连接——即使它们在同一 WiFi 网络中。要让 API 可被局域网内其他设备访问，必须显式指定监听地址为本机的局域网 IPv4 地址，并确保网络与系统层面允许该连接。

✅ 正确启动方式：绑定到局域网 IP

在项目根目录下，运行以下命令（将 192.168.2.222 替换为你本机实际的 IPv4 地址）：

php artisan serve --host=192.168.2.222 --port=8000

? 提示：可通过 ipconfig（Windows）或 ifconfig / ip a（macOS/Linux）确认本机 IPv4 地址（通常位于 Wi-Fi 或 wlan0 网卡段，形如 192.168.x.x 或 10.0.x.x）。切勿使用 127.0.0.1 或 localhost。

启动成功后，终端会显示：

Laravel development server started: http://192.168.2.222:8000

此时，在另一台电脑浏览器中输入 http://192.168.2.222:8000/api/your-endpoint 即可直接调用你的 API。

⚠️ 常见问题与解决方案

• 错误：Connection refused 或无法加载页面
  → 检查 Windows/macOS 防火墙是否阻止了 php 或端口 8000：

  • Windows：进入「Windows Defender 防火墙」→「高级设置」→「入站规则」→ 新建规则，允许 TCP 端口 8000；
  • macOS：系统设置 → 隐私与安全性 → 防火墙 → 防火墙选项 → 允许 php 进程通信。

• 错误：Address already in use
  → 表明端口被占用，可更换端口（如 --port=8080），或先终止占用进程：

  # Windows（查找并结束 PID）
  netstat -ano | findstr :8000
  taskkill /PID  /F
  
  # macOS/Linux
  lsof -i :8000
  kill -9 

• 仍无法访问？验证基础连通性
  在客户端 PC 上执行：

  ping 192.168.2.222
  telnet 192.168.2.222 8000  # 若无 telnet，可用 nc -zv 192.168.2.222 8000

  若 ping 通但 telnet 失败，说明服务未正确监听或被防火墙拦截。

? 安全提醒（重要！）

php artisan serve 仅适用于开发环境，不适用于生产部署。绑定局域网 IP 后，任何能访问该 IP 的设备均可请求你的 API —— 请确保：

• 不在公网暴露此服务；
• 避免在调试期间启用敏感接口（如 /api/admin/delete-all）；
• 调试完成后及时关闭服务（Ctrl + C）。

✅ 总结

只需一条命令即可实现跨设备 API 测试：

php artisan serve --host=<你的局域网IPv4> --port=<自选端口>

配合防火墙放行与基础网络诊断，95% 的“局域网访问失败”问题都能快速解决。记住：不是改前端请求地址，而是让后端服务主动“走出 localhost”。