Shopware 6编译报错：node_modules为空且Chromium下载失败

1. 不要在店铺根目录执行npm install #

Shopware 6的前端依赖是按模块独立管理的，根目录没有对应的package.json文件，直接执行不会生效。正确的操作是进入storefront模块的前端目录执行：

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

这样才会安装该模块所需的所有前端依赖，包括报错里提到的Chromium相关组件。

2. 成熟staging系统执行的安全性分析 #

在已安装多扩展、自定义主题的staging系统执行npm install，只要注意以下几点，就是安全的：

• 先备份关键文件：备份当前的node_modules目录（如果存在）以及自定义主题的前端源码，避免依赖安装过程中出现意外覆盖或损坏
• 确保版本匹配：确认你的staging系统Shopware版本与vendor/shopware/storefront模块版本完全一致，避免版本不兼容导致的依赖冲突
• 单独处理扩展/主题的依赖：如果你的自定义主题或第三方扩展有自己的前端目录（比如custom/plugins/xxx/Resources/app/storefront/），这些目录的依赖需要单独进入对应目录执行npm install，不要和官方storefront的依赖操作混在一起
• 清理缓存后重新编译：依赖安装完成后，执行./bin/build-storefront.sh --clear-cache，确保编译过程使用新安装的依赖，避免缓存导致的问题

额外解决Chromium下载失败的小技巧 #

如果反复执行npm install还是无法下载Chromium，可以尝试跳过内置Chromium下载，改用系统已安装的版本：

PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true npm install

之后确保系统已通过包管理器安装了Chromium（比如Debian/Ubuntu用apt install chromium，CentOS/RHEL用dnf install chromium），这样编译时会调用系统的Chromium，绕过下载失败的问题。

内容的提问来源于stack exchange，提问作者Steve Krämer