Shopware SwagPayPal模块引发JS构建错误，求解决方法

错误信息 #

ERROR in /var/www/html/content/web/vendor/store.shopware.com/swagpaypal/src/Resources/app/storefront/src/swag-paypal.abstract-buttons.js
Module not found: Error: Can't resolve '@paypal/paypal-js' in '/var/www/html/content/web/vendor/store.shopware.com/swagpaypal/src/Resources/app/storefront/src'

错误原因 #

SwagPayPal模块的前端代码依赖@paypal/paypal-js这个npm包，但该包未被安装到店面的前端依赖环境中。Composer仅负责管理PHP后端依赖，前端npm包需要单独安装；模块激活后，其前端依赖会被注入到Storefront的package.json中，但需要手动执行依赖安装命令来拉取这些包。

解决步骤 #

• 确认SwagPayPal模块已激活
  执行以下命令查看模块状态，确保SwagPayPal处于Active状态：

  bin/console plugin:list
  

  若未激活，执行激活命令：

  bin/console plugin:install SwagPayPal -a
  

• 清理项目缓存

  bin/console cache:clear
  

• 安装/更新前端依赖
  方法一：使用Shopware官方psh脚本（项目根目录下执行）：

  ./psh.phar storefront:install-dependencies
  

  方法二：直接进入Storefront目录执行npm命令：

  cd vendor/shopware/storefront/Resources/app/storefront/
  npm install
  

• 重新执行店面构建
  运行你原来的构建脚本：

  ./build-storefront.sh
  

  或使用官方构建命令：

  ./psh.phar storefront:build
  

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