html中js添加时间戳,部署后自动替换,避免缓存

问题:

自开发资源的内容,通过发布应用(重新部署前端后端资源)来实现,但是最新资源会替换到app.abc1.js 中的一个字符串(app.abc1.js资源更新内容,但是资源地址没有任何变化)。再结合js资源缓存策略配置的是强缓存+协商缓存,导致重新部署后,应用端自开发资源还是老旧资源

缓存策略如下:

虽然没有设置强缓存,但是会受到默认缓存的影响,走了强缓存无Cache-Control、Expires下浏览器默认强缓存

解决方案:

方案一:不使用强缓存,明确设置Cache-Control: max-age=0,缺点:资源每次都要加载,消耗宽带,也增大了LCP时间

方案二:针对重新发布这个业务操作,在发布的时候,给后端预设时间戳占位字符。利用资源请求地址不一致会重新加载最新资源的特性,获取最新app.js资源。旧地址:app.abc.js?timestamp=1752808486700 ->新地址: app.abc.js?timestamp=1752808511200

优点:可针对资源加时间戳,只在需要的时候更新资源

实现如下:

项目:vue2.7 文件:vue.config.js

js 复制代码
new (class AppTimestampPlugin {
    apply(compiler) {
      compiler.hooks.afterEmit.tapAsync('AppTimestampPlugin', (compilation, callback) => {
        try {
          const outputPath = compilation.outputOptions.path
          this.processTimestamp(outputPath)
          callback()
        } catch (error) {
          callback(error)
        }
      })
    }

    // 为HTML文件中的app.js添加时间戳占位符
    addTimestampToScripts(folderPath) {
      const fs = require('fs')
      const path = require('path')

      fs.readdirSync(folderPath).forEach((file) => {
        const filePath = path.join(folderPath, file)
        const stats = fs.statSync(filePath)

        if (stats.isDirectory()) {
          this.addTimestampToScripts(filePath)
        } else if (path.extname(file) === '.html') {
          let content = fs.readFileSync(filePath, 'utf-8')

          // 匹配包含 "app." 的 js 文件,如 js/app.12345678.js 或 app.12345678.js
          content = content.replace(
            /<script([^>]*)\s+src=["']([^"']*[\/]?app\.[^"']*\.js)(?!\?[^"']*timestamp)["']([^>]*)>/gi,
            (match, beforeSrc, srcUrl, afterSrc) => {
              const separator = srcUrl.includes('?') ? '&' : '?'
              const newSrc = `${srcUrl}${separator}timestamp=___TIMESTAMP___`
              return `<script${beforeSrc} src="${newSrc}"${afterSrc}>`
            }
          )

          fs.writeFileSync(filePath, content, 'utf-8')
        }
      })
    }
    processTimestamp(outputPath) {
      this.addTimestampToScripts(outputPath)
    }
  })()

总结

简单好用,解决了资源缓存问题

祝愿生活愉快

相关推荐
feixing_fx10 分钟前
第一个 JS 程序:在浏览器控制台和 Node 中分别运行
开发语言·前端·javascript·前端框架·ecmascript
feixing_fx1 小时前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
JavaGuide4 小时前
Cloudflare 开源的这套神级安全审计 Skill 太好用了!
前端·后端
孟健5 小时前
用 unslop 拯救 AI 生成网页的塑料感,7 分钟重构落地实测
前端·人工智能·ai编程
feixing_fx5 小时前
JavaScript 是什么:从浏览器脚本到通用编程语言
开发语言·前端·javascript·前端框架·ecmascript
丘山望岳5 小时前
【开发工具】 cluade code常用快捷键
前端
小巫编程室5 小时前
我造了一个 Java 能力包:让 AI 直接调用你的业务代码
java·前端·后端
小y的笔记6 小时前
JavaScript URL 状态同步
前端·javascript
十有八七6 小时前
手搓 Agent(五):学会翻书——RAG,先查资料再回答
前端·人工智能·后端
Swot6 小时前
产品 RAG 知识库与 AI 顾问 设计与实现
前端·后端