Nuxt 3引入nuxt-mail模块出现路径重复错误求助

错误原因 #

你遇到的路径重复问题，本质是使用了不兼容Nuxt 3的nuxt-mail旧版本。旧版nuxt-mail（v3.x及以下）是为Nuxt 2设计的，其构建逻辑无法适配Nuxt 3的虚拟模块路径处理机制，导致生成重复的项目路径，最终触发导入解析失败。

解决步骤 #

1. 卸载旧版模块
   执行命令卸载当前安装的nuxt-mail：

   npm uninstall nuxt-mail
   # 或 yarn remove nuxt-mail
   

2. 安装Nuxt 3兼容版本
   安装适配Nuxt 3的最新版nuxt-mail：

   npm install nuxt-mail@latest
   # 或 yarn add nuxt-mail@latest
   

3. 调整配置格式
   新版本的nuxt-mail不再需要数组嵌套式配置，修改nuxt.config.ts为如下格式：

   export default defineNuxtConfig({
     modules: [
       'nuxt-mail'
     ],
     mail: {
       message: {
         to: process.env.MAIL_TO,
       },
       smtp: {
         host: process.env.SMTP_HOST,
         port: process.env.SMTP_PORT,
         auth: {
           user: process.env.SMTP_USER,
           pass: process.env.SMTP_PASS,
         },
       },
     }
   })
   

4. 清理缓存并重启项目
   删除Nuxt的缓存目录，避免旧构建残留：

   npx nuxt clean
   

   之后重新启动开发服务：

   npm run dev
   

5. 验证环境变量
   确保.env文件中已正确配置所有邮件相关环境变量：

   MAIL_TO=your-target-email@example.com
   SMTP_HOST=your-smtp-host.com
   SMTP_PORT=587
   SMTP_USER=your-smtp-username@example.com
   SMTP_PASS=your-smtp-password
   

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