Nuxt3 Nitro服务器自定义FS存储插件使用问题求助

问题根源 #

1. 你在插件里创建了全新的storage实例，但useStorage()调用的是Nitro默认的全局存储，两者完全独立，所以你的API根本没用到自定义挂载的local_db。
2. 生产环境中，相对路径./.azdata的解析依赖当前工作目录，而Nitro部署后的运行目录不一定是项目根，导致路径失效；同时nuxt.config里的配置会被编译成开发机的绝对路径，也无法适配生产环境。

修复步骤 #

1. 挂载到Nitro全局存储，而非创建新实例

修改/server/plugins/my-custom-storage.ts，直接获取Nitro的默认存储并挂载驱动：

import fsDriver from 'unstorage/drivers/fs';
import pino from 'pino';

export default defineNitroPlugin(async (nitroApp) => {
  const logger = pino();
  // 获取Nitro全局存储实例
  const storage = nitroApp.storage;
  // 使用Nitro提供的项目根目录环境变量，确保路径在生产环境正确
  const rootDir = process.env.NITRO_APP_ROOT_DIR || process.cwd();
  const basePath = `${rootDir}/.azdata`;

  logger.info('mounting custom fs storage at ' + basePath);
  storage.mount('local_db', fsDriver({ base: basePath }));
});

2. 保持API调用逻辑不变

/server/api/my-custom-api.get.ts不需要修改，现在useStorage()会直接访问到挂载的local_db：

export default defineEventHandler(async (_event) => {
  const storage = useStorage();
  try {
    const myFile = await storage.getItem('local_db:path:to:myfile');
    return myFile;
  } catch (err: any) {
    console.error(err);
  }
});

3. 修正nuxt.config.ts的存储配置（可选）

如果还需要保留test_db，同样改用动态路径避免硬编码：

export default defineNuxtConfig({
  nitro: {
    storage: {
      test_db: {
        driver: 'fs',
        // 使用NITRO_APP_ROOT_DIR动态拼接路径
        base: `${process.env.NITRO_APP_ROOT_DIR || process.cwd()}/.test-data/`
      }
    }
  }
});

关键要点 #

• process.env.NITRO_APP_ROOT_DIR是Nitro自动设置的环境变量，指向项目的根目录，无论开发还是生产环境都能正确获取。
• 不要在插件中创建独立的storage实例，直接复用Nitro全局存储，这样useStorage()才能访问到你挂载的驱动。
• 避免使用相对路径./xxx，改用基于项目根的绝对路径，确保部署后路径解析正确。

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