Laravel 9运行npm run dev命令卡在APP_URL行如何解决

问题表现 #

Laravel 9项目执行npm run dev命令时，进程输出到APP_URL行后就卡住无后续响应，该命令此前运行完全正常，无同类报错历史。

排查修复步骤 #

按优先级从高到低操作即可：

• 先检查项目根目录.env文件的APP_URL配置项：确保值没有多余的末尾斜杠、没有复制粘贴带进来的不可见特殊字符，标准格式参考APP_URL=http://127.0.0.1:8000，修改完执行php artisan config:clear清掉配置缓存，重新跑命令测试
• 配置没问题的话，先释放Vite默认占用的5173端口：
  • Windows系统：执行netstat -ano | findstr :5173查到占用端口的进程PID，再执行taskkill /F /PID 查到的对应PID号强杀进程
  • Mac/Linux系统：直接执行lsof -i :5173 | grep LISTEN | awk '{print $2}' | xargs kill -9一键释放端口，之后重新启动命令
• 端口没被占还是卡的话，直接删掉项目根目录下的node_modules文件夹和package-lock.json文件，重新执行npm install安装全量前端依赖，装完再跑npm run dev基本都能恢复
• 以上操作都无效的话，检查vite.config.js配置文件，确认没有手动配置错误的server host参数，可先替换为Laravel官方默认配置测试：

import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';

export default defineConfig({
    plugins: [
        laravel({
            input: ['resources/css/app.css', 'resources/js/app.js'],
            refresh: true,
        }),
    ],
});

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