TensorFlow Hub突发403错误原因排查求助

问题背景 #

一年前创建的TensorFlow.js项目此前运行正常，今日突然出现模型加载失败：

• 加载以下TF Hub模型地址时返回403响应，伴随CORS错误：
  • https://tfhub.dev/tensorflow/tfjs-model/blazeface
  • https://tfhub.dev/mediapipe/tfjs-model/facemesh
  • https://tfhub.dev/mediapipe/tfjs-model/iris
• 浏览器直接访问这些URL可正常跳转并获取文件，但项目通过依赖库加载时触发403+CORS，本地开发和线上环境均受影响，第三方示例项目也出现相同问题。
• 项目依赖版本：

  "@tensorflow-models/face-landmarks-detection": "0.0.3",
  "@tensorflow/tfjs": "^3.15.0"
  

原因分析 #

1. TF Hub跨域策略更新：近期TF Hub调整了模型分发的CORS规则，旧版本TensorFlow.js（3.x及以下）的请求头格式不符合新规则，导致跨域请求被拦截，返回403。
2. 旧依赖库的硬编码URL问题：@tensorflow-models/face-landmarks-detection@0.0.3是2021年的旧版本，内部硬编码的TF Hub模型地址未适配TF Hub最新的重定向逻辑，重定向后的Google Cloud Storage地址对旧版tfjs的请求未开放跨域权限。
3. 广泛影响：该问题并非个例，近期大量使用旧版tfjs和模型库的项目都出现了相同故障，属于TF Hub服务端规则变更引发的兼容性问题。

解决方案 #

1. 升级依赖包（推荐） #

将相关依赖升级到适配TF Hub新规则的版本：

• 升级@tensorflow-models/face-landmarks-detection至最新稳定版（如0.0.7）
• 同步升级@tensorflow/tfjs至匹配版本（推荐4.10.0及以上）
  更新后的依赖示例：

"@tensorflow-models/face-landmarks-detection": "^0.0.7",
"@tensorflow/tfjs": "^4.10.0"

新版本库已更新模型加载逻辑，自动适配TF Hub的最新地址和跨域规则。

2. 本地托管模型（临时替代） #

若无法立即升级依赖，可手动下载模型文件并托管到自己的服务：

1. 从浏览器跳转后的地址下载完整模型文件（包括权重文件）
2. 将模型文件部署到自己的静态资源服务器（如CDN、本地静态服务）
3. 修改项目中模型加载的配置，指定本地模型地址（需参考face-landmarks-detection库的文档，覆盖默认模型URL）

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