Laravel+TailwindCSS项目部署Cpanel时yarn build内存不足错误求助

以下是针对你遇到的RangeError: WebAssembly.instantiate(): Out of memory问题的具体解决办法：

• 调高Node.js进程内存限制
  直接在构建命令前添加内存参数，提升V8引擎的内存分配上限，比如：

  NODE_OPTIONS="--max-old-space-size=4096" yarn run build
  

  数值4096代表4GB内存，可根据服务器实际可用内存调整（比如服务器内存紧张就设为2048）。Cpanel默认的Node进程内存配额通常较低，这个参数能直接缓解内存不足问题。

• 优化TailwindCSS构建配置

  1. 缩小文件扫描范围：在tailwind.config.js的content字段里只保留项目实际用到的文件路径，避免扫描无关目录，示例：

     content: [
       './resources/views/**/*.blade.php',
       './resources/js/**/*.js',
       './resources/js/**/*.vue'
     ]
     

  2. 确认启用JIT模式：Tailwind v3默认启用JIT，若你用的是旧版本，在tailwind.config.js中添加mode: 'jit'，JIT模式只会生成项目实际用到的样式，大幅降低构建时的内存占用。

• 清理缓存后重新构建

  1. 清理Node依赖缓存并重装：

     yarn cache clean
     rm -rf node_modules yarn.lock
     yarn install
     

  2. 清理Laravel缓存，避免旧配置干扰：

     php artisan cache:clear
     php artisan config:clear
     

  完成后再尝试执行yarn run build。

• 对齐Node.js版本
  检查本地开发环境的Node版本（执行node -v），在Cpanel的Software板块找到Select Node.js Version，切换到和本地一致的版本，版本差异可能导致内存管理逻辑不一致，引发内存溢出。

• 尝试分步构建
  若一次性构建内存压力过大，可拆分步骤执行：

  # 先执行开发环境构建验证
  yarn run dev
  # 再执行生产环境构建
  yarn run production
  

  或者直接调用Laravel Mix命令：

  npx mix --production
  

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