开发Shopware 6 Storefront App：部署后JS未执行需重建问题求助

你遇到的核心问题是：你提前在本地编译了Storefront的JS资源，而Shopware 6的应用机制要求以未编译的源码形式交付资源，由商店端的构建系统统一编译整合。本地编译的bundle.js依赖本地环境的配置、依赖版本，和目标商店的Storefront环境不兼容，所以无法直接运行。

具体修正步骤 #

• 停止本地执行./bin/build-storefront.sh编译应用的Storefront资源
  你的应用不需要提前编译JS，应该保留src/Resources/app/storefront/目录下的未编译源码（比如main.js、自定义组件/模块文件），不要将本地生成的dist/目录打包进应用zip。

• 正确配置应用的manifest.xml
  在应用的manifest.xml中声明Storefront资源的入口文件，让Shopware识别需要整合的资源：

  <manifest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/shopware/platform/trunk/src/Core/Framework/App/Manifest/Schema/manifest-1.0.xsd">
      <!-- 其他配置 -->
      <assets>
          <storefront>
              <entry-file>src/Resources/app/storefront/main.js</entry-file>
          </storefront>
      </assets>
  </manifest>
  

• 调整应用打包内容
  打包应用zip时，只包含核心文件：src/、composer.json、manifest.xml、README.md等，排除dist/、node_modules/、var/等本地生成或依赖目录。

• 理解Shopware的自动构建逻辑
  客户安装应用后，Shopware会自动触发Storefront资源的整合流程：

  1. 通过bin/console assets:install将应用的资源复制到公共目录
  2. 自动或提示用户执行bin/build-storefront.sh（或后台的「重建Storefront」按钮）完成全局编译
     这个过程是Shopware应用生态的标准流程，客户无需手动复杂操作，商店后台会有明确提示引导完成。

关键误区提醒 #

本地编译的bundle.js包含了本地Storefront的依赖版本、路径映射、编译哈希，这些和目标商店的环境完全不匹配，直接上传会导致JS无法加载或执行失败。必须依赖Shopware的全局构建系统来统一处理所有应用的资源，才能保证兼容性和稳定性。

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