Laravel 9 + ReactJS + Vite 执行npm run dev出现net::ERR_CONNECTION_REFUSED错误

• 先确认Vite开发服务是否真的启动成功
  执行npm run dev后看终端输出，正常会显示Local: http://localhost:5173/这类地址，如果终端没输出或者直接报错，先解决Vite启动的基础问题；要是终端显示服务启动但浏览器连不上，大概率是IPv6的兼容问题，强制用IPv4启动就行。

• 修改Vite配置强制使用IPv4
  找到项目根目录的vite.config.js（或vite.config.ts），添加server配置：

  export default defineConfig({
    server: {
      host: '127.0.0.1',
      port: 5173
    },
    // 保留原有其他配置
  })
  

  重启npm run dev，此时浏览器请求会指向http://127.0.0.1:5173，而非[::1]。

• 检查Laravel Blade模板的Vite指令
  确保blade文件里用的是官方Vite指令，别手动写链接：

  @vite(['resources/css/app.css', 'resources/js/app.jsx'])
  

  Laravel的Vite指令会自动根据环境生成正确的资源路径，手动写容易出错。

• 清理缓存并重装依赖

  • 清理Laravel缓存：php artisan cache:clear、php artisan view:clear
  • 删除旧依赖文件：rm -rf node_modules package-lock.json（Windows系统用rmdir /s node_modules && del package-lock.json）
  • 重装依赖：npm install
  • 重启Vite服务：npm run dev

• 排查防火墙或代理干扰
  本地防火墙可能拦截了5173端口，临时关闭防火墙测试；如果用了VPN、代理工具，先关掉再尝试访问。

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