提交

miniprogram/utils/ossCache.js

@@ -0,0 +1,81 @@
+// 统一给 OSS/MinIO/静态域资源追加版本参数（用于绕过长缓存）。
+// 约束：不要用 Date.now() 常态化破缓存；默认用“可控版本号”，需要强刷时只改版本号即可。
+
+let _cachedVersion = null
+// TODO(config-hardcoded): 资源版本号当前写死，后续改为构建产物自动注入（如 commit hash / CI build number）。
+const STATIC_ASSETS_VERSION = '20260423'
+
+// 作为兜底版本号来源（构建期静态注入）
+// eslint-disable-next-line import/no-unresolved
+import manifest from '@/manifest.json'
+
+function fallbackVersionFromManifest() {
+  try {
+    const vn = String(manifest?.versionName || '').trim()
+    const vc = String(manifest?.versionCode || '').trim()
+    return [vn, vc].filter(Boolean).join('.')
+  } catch {
+    // ignore
+  }
+  return ''
+}
+
+/**
+ * 统一版本号：
+ * - 写死常量：`STATIC_ASSETS_VERSION`
+ * - 兜底：manifest.versionName/versionCode
+ * - 最终兜底：固定日期
+ */
+export function getStaticAssetsVersion() {
+  if (_cachedVersion != null) return _cachedVersion
+  const v =
+    STATIC_ASSETS_VERSION ||
+    fallbackVersionFromManifest() ||
+    '20260423'
+  _cachedVersion = String(v || '').trim()
+  return _cachedVersion
+}
+
+function hasSignedQuery(u) {
+  // 预签名/鉴权 URL：追加参数可能导致签名失效，必须跳过
+  return /(?:[?&](?:X-Amz-|x-amz-|OSSAccessKeyId|Signature|x-oss-|Expires)=)/.test(u)
+}
+
+function hasVersionParam(u) {
+  return /(?:[?&]v=)/i.test(u)
+}
+
+function looksLikeOurObjectStorage(u) {
+  // 只对我们自己的 OSS/MinIO/静态域处理，避免误伤第三方资源
+  return (
+    u.includes('/sqxp-static/') ||
+    u.includes('/sanqiang/') ||
+    u.includes('/minio/') ||
+    /:\/\/(?:www\.)?chengyantek\.cn\//i.test(u) ||
+    /:\/\/\d{1,3}(?:\.\d{1,3}){3}:20004\//.test(u)
+  )
+}
+
+function appendQueryParam(url, key, value) {
+  const sep = url.includes('?') ? '&' : '?'
+  return `${url}${sep}${encodeURIComponent(key)}=${encodeURIComponent(value)}`
+}
+
+/**
+ * 给 OSS/MinIO/静态域 URL 追加 `v=<version>`，用于“内容更新但 URL 不变”时强制刷新。
+ *
+ * - 已带 `v=`：不重复追加
+ * - 预签名 URL：不追加（避免签名失效）
+ * - 非 http(s) / // / 非本站存储域：不处理
+ */
+export function withOssVersion(rawUrl, version = getStaticAssetsVersion()) {
+  const u = String(rawUrl || '').trim()
+  if (!u) return ''
+  if (!(u.startsWith('http://') || u.startsWith('https://') || u.startsWith('//'))) return u
+  if (!version) return u
+  if (!looksLikeOurObjectStorage(u)) return u
+  if (hasVersionParam(u)) return u
+  if (hasSignedQuery(u)) return u
+  return appendQueryParam(u, 'v', version)
+}
+