Tina.io CMS引用集合内容在Vercel部署后未更新问题求助

核心原因分析 #

Tina在静态构建时，若查询仅获取引用对象的ID而非完整关联数据，或者未配置引用集合的静态生成规则，会导致构建产物中未包含引用条目的最新内容；而/admin模式是实时从CMS拉取数据，所以能正常显示。

具体修复步骤 #

• 检查Tina查询语句：确保查询中明确请求引用字段的关联数据，而非仅获取引用ID。示例：

  query getPost($relativePath: String!) {
    post(relativePath: $relativePath) {
      title
      author { # 明确请求引用集合的具体字段
        name
        avatar
      }
    }
  }
  

• 配置Tina静态生成规则：在tina/config.ts中，确保引用的集合被包含在build配置的collections列表内；或者在页面的getStaticProps中触发对引用集合的预查询，让Vercel构建时能抓取最新的引用数据。
• 清除Vercel构建缓存：构建缓存可能复用旧内容，可在Vercel项目的构建设置中手动清除缓存，重新触发构建。
• 验证Git提交一致性：确认修改的.md文件已正确推送到GitHub对应分支，且Vercel构建的分支与提交分支一致。

额外排查点 #

• 检查Tina Client版本，部分旧版本存在引用数据静态化bug，尝试升级至最新稳定版。
• 查看Vercel构建日志，确认是否有引用集合数据拉取相关的警告或错误信息。

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