裸查询字符串不再导致资源缓存失效

需要采取行动

我们正在优化 Shopify 的资产缓存机制，以提升加载速度。作为此次更新的一部分，我们将调整用于清除缓存的 URL 查询参数的识别方式。

自2026年3月24日起，裸查询字符串（?后接无键的值）将不再刷新缓存的资产。此前，这些字符串看似能刷新资产，因为修改URL可以绕过缓存；这种偶然行为将被停止。

如果您的资产URL是使用Liquid过滤器（例如asset_url）生成的，那么您已经兼容——无需进行任何更改。

变更内容

引用资产（例如图片、字体）时，如果 URL 包含裸查询字符串（bare query string），当该值更新时将不再刷新已缓存的资产。

例如：

image.png?123

CSS 中的情况同样适用：

background-image: url('image.png?123');

应对措施

使用适当的Liquid过滤器来生成URL（例如asset_url、file_url）。Shopify会处理版本控制，并在资产发生变化时自动更新URL。

在模板中：

{{ 'image.png' | asset_url }}

这将输出带有版本参数的 URL：

image.png?v=1384022871

在CSS中，使用.css.liquid文件来集成Liquid：

background-image: url('{{ "image.png" | asset_url }}');

为何重要

继续使用裸查询字符串可能导致在缓存过期前提供过时的资产。使用 Liquid 过滤器可确保交付每个资产的准确最新版本，从而通过更有效的 CDN 和浏览器缓存提升性能。

了解更多

• asset_url 过滤器
• file_url 过滤器
• 确保自动更新的 CSS 语法