supportsImmutableAssets
配置对不可变静态资源的支持
注意:此选项主要面向适配器作者。 应用开发者只应在排查特定于适配器的问题时设置它。
当你的提供商或适配器不支持此功能时启用它,可能会导致部署损坏。
启用 skew protection(偏差保护)时,静态资源请求会包含一个特定于部署的查询参数,例如:
plain
GET https://foo.com/_next/static/chunks/0d_ks0ow7ur6m.js?dpl=<unique-deployment-id>一个缺点是,每次新部署后浏览器都必须重新下载静态资源,即使这些资源没有变化。
不可变静态资源允许对那些保证不可变且通过文件名进行内容寻址的静态资源省略 ?dpl 查询参数。这让浏览器可以无限期缓存这些资源,并在后续部署期间上传文件时跳过未更改的静态资源:
plain
GET https://foo.com/_next/static/immutable/chunks/0d_ks0ow7ur6m.js当适配器启用了对不可变静态资源的支持时,你可以使用此配置选项选择不使用它。如果你的适配器未启用此功能,则此选项无效:
next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
supportsImmutableAssets: false,
}
module.exports = nextConfig请参阅支持不可变静态资源,了解有关如何在适配器中支持此功能的更多信息。
版本历史#
| 版本 | 变更 |
|---|---|
v16.3.0 | 增加对不可变静态资源的支持。 |