Nuxt 3应用中数据库连接初始化及API上下文注入位置咨询

你需要用异步Nitro插件来实现，它完全满足你的三个需求，同时避开全局变量的问题：

步骤1：创建异步Nitro插件 #

在server/plugins目录下新建db-connection.ts文件（Nuxt会自动加载该目录下的所有插件）：

export default defineNitroPlugin(async (nitroApp) => {
  // 1. 获取运行时配置，满足条件b
  const config = useRuntimeConfig()
  
  // 2. 异步建立数据库连接，满足条件a（服务器启动时运行）
  const dbConnection = await connectToDatabase({
    host: config.dbHost,
    port: config.dbPort,
    user: config.dbUser,
    password: config.dbPassword,
    database: config.dbName
  })

  // 3. 监听每个请求，把连接注入到请求上下文，满足条件c
  nitroApp.hooks.hook('request', (event) => {
    event.context.db = dbConnection
  })

  // 可选：服务器停止时关闭连接，避免资源泄漏
  nitroApp.hooks.hook('close', async () => {
    await dbConnection.close()
  })
})

// 替换为你实际的数据库连接逻辑
async function connectToDatabase(options: {
  host: string;
  port: number;
  user: string;
  password: string;
  database: string;
}) {
  // 示例：用pg库连接PostgreSQL
  // const { Client } = require('pg')
  // const client = new Client(options)
  // await client.connect()
  // return client

  // 替换成你使用的数据库库的连接代码
  const connection = await yourDbLibrary.connect(options)
  return connection
}

步骤2：在API路由中使用连接 #

比如在server/api/fetch-data.get.ts里：

export default defineEventHandler(async (event) => {
  // 从请求上下文获取数据库连接
  const db = event.context.db
  
  // 执行数据库操作
  const result = await db.query('SELECT * FROM your_table')
  
  return { data: result.rows }
})

关键说明 #

• Nitro插件支持异步初始化：你之前的误解是错误的——Nitro插件本身可以是异步函数，Nuxt会在服务器启动时等待插件执行完成后再处理请求。
• 拒绝全局变量：通过request钩子将连接注入到每个请求的上下文，而非全局存储，更符合Nuxt的请求隔离设计。
• 运行时配置可直接访问：useRuntimeConfig()在Nitro插件中可以直接调用，能获取到你在nuxt.config.ts中配置的数据库参数。

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