Next.js generateMetadata调用Sanity返回空结果的求助

1. 环境变量配置问题 #

你的sanity/lib/api.tsx依赖NEXT_PUBLIC_前缀的环境变量，需逐一确认：

• 项目根目录存在.env.local文件，变量名完全匹配（NEXT_PUBLIC_SANITY_PROJECT_ID、NEXT_PUBLIC_SANITY_DATASET、NEXT_PUBLIC_SANITY_API_VERSION）
• 变量值准确：projectId是Sanity后台的项目ID，dataset是你实际使用的数据集名称（如production），apiVersion必须为YYYY-MM-DD格式（如2024-01-01，不能用模糊版本号）
• 若刚创建.env.local文件，需重启Next.js开发服务器才能加载新变量

2. Sanity CORS配置未放行当前域名 #

Sanity默认限制跨域请求，需在后台配置：

• 进入Sanity项目 → 设置 → API → CORS origins
• 添加本地开发地址http://localhost:3000（生产环境替换为你的实际域名）
• 勾选「Allow credentials」选项后保存

3. 目标文档未发布或不存在 #

你的查询*[_type == "settings"][0]依赖已发布的文档：

• 确认Sanity后台存在_type为settings的文档
• 该文档已点击「发布」按钮（客户端设置perspective: 'published'，草稿状态文档不会被返回）
• 在Sanity Vision测试查询时，确保选择的数据集与代码中dataset变量一致

4. Sanity客户端初始化异常 #

检查sanity/lib/client.tsx的配置细节：

• apiVersion必须是有效的日期格式，无效值会导致请求失败
• 若你的Sanity项目开启了「公开数据需认证」，需在客户端配置中添加只读token（存在非NEXT_PUBLIC_前缀的环境变量中，避免泄露敏感信息）

5. 捕获请求错误定位问题 #

在generateMetadata中添加错误捕获，查看具体报错信息：

export async function generateMetadata() {
  try {
    const settings = await client.fetch(settingsQuery)
    console.log({ settings })
  } catch (error) {
    console.error('Sanity请求错误:', error)
  }
  return {
    title: 'This is a test',
  }
}

错误信息会直接提示问题根源，比如权限不足、网络问题、查询语法错误等

内容的提问来源于stack exchange，提问作者GʀᴜᴍᴘʏCᴀᴛ