PrestaShop 1.7商品页JS加载异常：路径错误与未定义报错排查

我在footer.tpl文件中添加了如下代码，意图仅在商品页加载指定JS文件：

{if $page.page_name == 'product'}<script type="text/javascript" src="https://zapakowania.pl/themes/zapakowania1/assets/jss/bottom-d68634775.js"></script>{/if}

但PrestaShop实际加载了完全不同路径的文件，还出现“prestashop is not defined”错误。已排查其他.tpl文件，仅footer.tpl中有该JS路径，需求是替换商品页的JS文件而非追加。

问题核心原因 #

1. PrestaShop资产自动处理机制：开启合并压缩JS选项时，系统会自动合并主题JS并生成带版本号的新文件，不会直接加载你硬编码的单个文件。
2. JS加载顺序错误：自定义JS在PrestaShop核心JS之前执行，导致prestashop核心对象未初始化就被调用，触发报错。

解决步骤 #

1. 临时排查：禁用JS合并 #

进入后台高级参数 > 性能，将合并JavaScript文件设为否，保存后刷新商品页，确认是否加载了你指定的JS文件。此方法仅用于开发排查，生产环境不推荐。

2. 生产环境推荐：钩子替换JS #

在主题的functions.php中添加代码，通过钩子移除原有JS并注册新文件：

// 针对商品页替换底部JS
addAction('displayFooterProduct', function() {
    global $controller;
    if ($controller->php_self == 'product') {
        // 替换为原有JS的注册句柄（需根据主题实际修改，可查看assets/theme.yml或合并后的JS文件名）
        $controller->unregisterJavascript('theme-bottom');
        // 注册新的商品页JS
        $controller->registerJavascript('custom-product-bottom', 'https://zapakowania.pl/themes/zapakowania1/assets/jss/bottom-d68634775.js', ['position' => 'bottom', 'priority' => 100]);
    }
});

3. 主题资产配置替换（适用于新版主题） #

若主题使用assets/theme.yml管理资产，可在文件中针对商品页覆盖JS配置：

global:
  js:
    - id: theme-bottom
      path: assets/js/bottom.js
      priority: 100
product:
  js:
    - id: theme-bottom
      path: assets/jss/bottom-d68634775.js
      priority: 100

修改后清理后台缓存（高级参数 > 性能 > 清除缓存），系统会自动在商品页加载新JS。

4. 调整模板代码位置（硬编码方案） #

若必须在footer.tpl中添加代码，将代码移至核心钩子之后，确保核心JS已加载：

{hook h='displayFooter'}
{if $page.page_name == 'product'}
<script type="text/javascript" src="https://zapakowania.pl/themes/zapakowania1/assets/jss/bottom-d68634775.js"></script>
{/if}

5. 强制清理缓存 #

每次修改后，需清理两类缓存：

• 后台缓存：高级参数 > 性能 > 清除缓存
• 浏览器缓存：按Ctrl+Shift+R强制刷新页面

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