如何在Nuxt Server(Nitro)中实例化对象并全局提供其方法

方法一：Nitro插件（官方推荐方案） #

Nitro插件会在服务启动阶段执行，刚好匹配你要在启动时初始化实例的需求，且能让实例在所有服务端路由中便捷访问。

1. 创建服务端插件文件 server/plugins/notes-reader.ts：

import initNotesReader from '~/path/to/your/initNotesReader'

export default defineNitroPlugin((nitroApp) => {
  // 可从环境变量或Nuxt配置读取datadir，示例用默认路径
  const datadir = nitroApp.options.runtimeConfig.notes.datadir || './notes'
  const notesReader = initNotesReader(datadir)

  // 将实例挂载到Nitro应用上下文，供后续调用
  nitroApp.notesReader = notesReader
})

2. 在服务端路由中调用实例方法：
   示例详情接口 server/api/notes/[id].get.ts：

export default defineEventHandler(async (event) => {
  const { id } = getRouterParams(event)
  // 通过useNitroApp获取实例
  const notesReader = useNitroApp().notesReader
  const note = await notesReader.readNote(id)
  return { success: true, data: note }
})

示例列表接口 server/api/notes.get.ts：

export default defineEventHandler(async () => {
  const notesReader = useNitroApp().notesReader
  const list = await notesReader.listNotes()
  return { success: true, data: list }
})

方法二：Server Utils单例模式 #

如果不想用插件，也可以通过单例模式在server/utils中初始化，保证服务启动时仅实例化一次：

1. 创建 server/utils/notes-reader.ts：

import initNotesReader from '~/path/to/your/initNotesReader'

// 初始化单例，服务启动时执行一次
const datadir = process.env.NOTES_DATADIR || './notes'
export const notesReader = initNotesReader(datadir)

2. 在服务端路由中直接导入使用：

import { notesReader } from '~/server/utils/notes-reader'

export default defineEventHandler(async () => {
  return await notesReader.listNotes()
})

关键提示 #

• 确保initNotesReader内的readFile等操作是服务端兼容的，避免使用浏览器专属API。
• 若需从Nuxt配置读取datadir，建议用runtimeConfig，比如在nuxt.config.ts中配置：

export default defineNuxtConfig({
  runtimeConfig: {
    notes: {
      datadir: './my-notes' // 可通过环境变量覆盖，如NOT_DATADIR
    }
  }
})

• 两种方案都能保证实例仅初始化一次，不会在每次请求时重复创建，符合性能要求。

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