Nuxt3生产环境中共享代码读取.env文件问题求助

1. 调整环境变量的获取方式 #

Nuxt3的环境变量机制和Nuxt2不同，外部共享模块直接读取项目根目录的.env文件在生产构建后会失效，因为构建后环境变量需要通过Nuxt的runtimeConfig系统注入。

• 在MagicTools项目的nuxt.config.ts中，声明要暴露给服务端的环境变量：

export default defineNuxtConfig({
  runtimeConfig: {
    logsDir: process.env.LOGS_DIR, // 服务端可直接访问
    public: {} // 客户端无需的话留空
  }
})

• 修改Common文件夹下的Log.ts，通过Nuxt内置的useRuntimeConfig获取变量，替代直接读取.env：

// Common/Log.ts
import { useRuntimeConfig } from '#imports'

export default {
  setupLogger() {
    const config = useRuntimeConfig()
    const logsDir = config.logsDir
    // 这里写你的日志初始化逻辑
  }
}

注意：所有复用这个Common模块的Nuxt3项目，都要在各自的nuxt.config.ts中配置对应的runtimeConfig字段。

2. 确保共享模块被正确纳入构建 #

Nuxt3构建时只会处理项目目录内的文件，外部的Common文件夹如果用相对路径直接导入，可能无法被正确打包，导致生产环境找不到模块或代码未被转译。

方案A：将Common作为本地npm包引入 #

• 进入Common文件夹，初始化package.json：

cd ../Common
npm init -y

• 在package.json中设置一个合适的name（比如@your-name/common）
• 回到MagicTools项目，安装本地包：

npm install ../Common

• 之后导入方式改为：

import Log from '@your-name/common/Log'

这种方式能让Nuxt3自动识别并打包共享模块，避免路径问题。

方案B：配置Nuxt别名与构建规则 #

• 在MagicTools的nuxt.config.ts中添加别名和构建规则，让Nuxt识别外部模块：

import path from 'path'

export default defineNuxtConfig({
  alias: {
    '@common': path.resolve(__dirname, '../Common')
  },
  build: {
    extend(config) {
      config.module?.rules.push({
        test: /\.ts$/,
        include: [path.resolve(__dirname, '../Common')],
        use: 'ts-loader'
      })
    }
  }
})

• 导入时使用别名：

import Log from '@common/Log'

3. 检查生产环境的启动路径 #

生产环境启动时，如果不在MagicTools项目根目录执行命令，.env文件可能无法被正确加载。

• 确保在项目根目录启动服务：

cd /path/to/MagicTools
nodemon .output/server/index.mjs

• 如果需要指定自定义.env文件路径，可以用dotenv-cli辅助：

# 先安装dotenv-cli
npm install -g dotenv-cli
# 启动时指定env文件
NODE_ENV=production dotenv -e .env nodemon .output/server/index.mjs

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