Vue SSR无法获取unhead元数据问题求助

问题场景 #

• Vue3 SSR项目运行正常，采用unhead设置SEO信息
• 客户端页面加载完成后，标题及各类SEO标签显示正常
• 服务端渲染输出的HTML中完全没有配置的SEO标签

排查过程 #

最初误以为是SSR核心配置出错，反复校验服务端入口文件、渲染流程等配置项，确认SSR基础配置无问题。

解决方法 #

最终定位问题根源：根组件App.vue中未调用useHead或useSEO方法。

在App.vue中添加对应调用后，服务端渲染的HTML成功包含预设的SEO标签，问题彻底解决。

示例代码：

<!-- App.vue -->
<script setup>
import { useHead } from '@unhead/vue'

useHead({
  title: '自定义页面标题',
  meta: [
    { 
      name: 'description', 
      content: '这里是页面的描述内容' 
    }
  ]
})
</script>

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