Laravel 10项目部署时npm run命令执行失败求助

一、npm run dev 报错：无法扫描入口文件依赖 #

排查与解决步骤 #

• 验证入口文件存在性
  确认 /home/c/cn18045/public_html/resources/js/app.js 文件真实存在，无拼写错误或误删情况。若文件缺失，可从本地开发环境同步，或重新执行 php artisan breeze:install 生成基础JS文件。
• 清理依赖缓存并重装
  执行以下命令重置依赖环境：

  rm -rf node_modules package-lock.json
  npm cache clean --force
  npm install
  

• 检查Vite入口配置
  打开 vite.config.js，确认 input 字段指向的路径与实际文件一致：

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

二、npm run build 报错：无法加载vite.config.js配置文件 #

排查与解决步骤 #

• 检查配置文件完整性
  确认 vite.config.js 无语法错误、内容损坏或缺失。可使用Laravel 10标准模板配置替换：

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

• 校验依赖版本兼容性
  Laravel 10要求 vite 版本≥4.0、laravel-vite-plugin 版本≥0.7.0，检查 package.json 中的依赖版本后，执行更新：

  npm update vite laravel-vite-plugin
  

• 确认Node.js版本适配
  当前使用的Node.js 16.20.0符合Vite 4.x的最低要求（14.18+、16+），若仍有问题，可尝试切换至Node.js 18.x版本（服务器允许的前提下），或确认npm 9.x与当前Node版本的兼容性。

通用排查动作 #

• 确保在项目根目录执行命令
  操作时需处于 /home/c/cn18045/public_html 目录下，避免路径错误。
• 获取详细错误日志
  执行命令时追加 --debug 参数查看更多细节：

  npm run dev --debug
  npm run build --debug
  

  从日志中定位具体的依赖加载或配置解析问题。

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