Nuxt 3中searchContent始终返回空数组问题求助

问题 #

在Nuxt 3项目中使用@nuxt/content的searchContent()实现搜索功能时，始终返回空数组。相关信息如下：

• 依赖版本：vue 3.4.19、nuxt 3.10.2、nuxt/content 2.12.0
• Markdown文档存放于/content目录
• Nuxt配置：

export default defineNuxtConfig({
  devtools: { enabled: true },
  modules: ['@nuxt/ui', '@nuxt/content'],
  content: {
    experimental: {
      search: {
        indexed: true
      }
    }
  }
})

• 搜索代码片段：

const keywords = ref('')

const search = lodash.debounce(async () => {
    const res = await searchContent(keywords)
    console.log(res.value)
}, 500)

排查与解决方法 #

1. 修正searchContent参数传递错误 #

searchContent()需要接收字符串类型的关键词，你直接传入了Ref对象，要改成取value属性：

const search = lodash.debounce(async () => {
    // 传入keywords.value而非keywords本身
    const res = await searchContent(keywords.value)
    console.log(res)
}, 500)

2. 确认搜索索引已正确生成 #

开启experimental.search.indexed后，Nuxt Content会在构建时生成搜索索引，需要：

• 重启开发服务器（执行npm run dev），确保索引重新生成
• 检查.nuxt/content/search.index文件是否存在且有内容，空文件或不存在说明索引生成失败

3. 验证Markdown文档的有效性 #

• 确保/content下的Markdown文件不是空文件，有实际内容
• 检查文件是否有正确的Frontmatter格式，示例：

---
title: 测试文章
description: 这是一篇用于搜索测试的文章
---
正文内容，这里的文字也会被纳入搜索索引...

格式错误或空的文件不会被加入搜索索引

4. 检查依赖兼容性 #

可以尝试：

• 更新@nuxt/content到最新的2.x版本（2.12.0之后有后续更新）
• 执行npm install重新安装依赖，确保版本匹配无冲突

5. 添加调试信息定位问题 #

在搜索逻辑里增加调试输出，明确搜索状态：

const search = lodash.debounce(async () => {
    if (!keywords.value.trim()) {
        console.log('关键词为空')
        return
    }
    const res = await searchContent(keywords.value)
    console.log('当前搜索关键词:', keywords.value)
    console.log('搜索结果数量:', res.length)
    console.log('搜索结果详情:', res)
}, 500)

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