Laravel10+Vue3本地服务器运行时出现ERR_CONNECTION_REFUSED错误求助

以下是针对该环境下出现连接拒绝错误的常见原因及对应解决方法：

常见原因及解决方法 #

1. Laravel开发服务器未启动或异常终止 #

• 解决：打开Laragon终端，切换到项目根目录，执行php artisan serve。启动成功后终端会显示Server running on [http://127.0.0.1:8000]类提示。若启动失败，检查.env文件的APP_URL是否设置为http://127.0.0.1:8000，同时确认数据库连接配置无误；也可尝试重启Laragon后再次启动服务器。

2. 默认端口被占用 #

Laravel默认使用8000端口，若该端口被其他程序占用会导致无法连接。

• 解决：
  • 打开命令提示符，执行netstat -ano | findstr :8000，找到占用端口的进程PID；
  • 打开任务管理器，定位对应PID的进程并结束，之后重启Laravel服务器；
  • 或启动时指定其他端口：php artisan serve --port=8080，随后访问http://127.0.0.1:8080。

3. Laragon的Web服务未启动 #

Laragon依赖Apache或Nginx提供Web服务，若服务未运行会导致无法访问。

• 解决：打开Laragon面板，确认Apache/Nginx图标为绿色（运行状态）。若启动失败，检查80/443端口是否被IIS、迅雷等程序占用，可在Laragon设置中切换端口，或关闭占用程序后重启服务。

4. 防火墙/安全软件拦截 #

Windows防火墙或第三方安全软件可能会拦截本地服务器的连接请求。

• 解决：
  • 临时关闭Windows Defender防火墙，若能正常访问，需添加规则允许php.exe（Laravel服务器）或Laragon的Apache/Nginx程序通过防火墙；
  • 检查360、腾讯电脑管家等第三方安全软件的拦截规则，将127.0.0.1或相关程序加入白名单。

5. Vue3与Laravel的配置冲突（分两种场景） #

场景一：前后端分离，单独启动Vue服务

• 解决：确认Vue开发服务器已启动，进入Vue项目目录执行npm run dev，终端会显示访问地址（通常为http://localhost:5173）；同时检查Laravel的config/cors.php文件，确保allowed_origins包含Vue服务器地址（如'http://localhost:5173'）。

场景二：Laravel路由渲染Vue组件（非分离模式）

• 解决：确认路由配置正确指向Vue组件，执行npm run build完成组件编译后，再刷新页面。

6. Laragon站点配置错误 #

• 解决：在Laragon的「Sites」菜单中，确认当前项目已正确添加，且站点根目录指向Laravel项目的public文件夹（Laravel必须以public作为Web根目录）；同时检查本地域名（如myproject.test）是否配置正确。

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