NextJS中getStaticPaths内环境变量无法正常工作的问题

先排查基础错误 #

• 确认.env.local文件在项目根目录，文件名无后缀（比如不是.env.local.txt）
• 检查环境变量拼写：比如MONGODB_URI是否大小写正确，有没有写成MONGODB_URL
• 确认.env.local里的变量没有多余空格或引号，正确格式示例：

  DB_USER=your-user
  DB_PASS=your-pass
  MONGODB_URI=mongodb+srv://${DB_USER}:${DB_PASS}@cluster0.mongodb.net/your-db
  

核心修复：在getStaticPaths函数内部访问环境变量 #

Next.js的环境变量加载机制可能导致模块顶级作用域的变量提前读取时未初始化。如果你的代码是在函数外定义的变量，移到函数内部：

// 错误写法（顶级作用域提前读取）
const uri = process.env.MONGODB_URI;

export async function getStaticPaths() {
  // uri可能为undefined
  const client = await MongoClient.connect(uri);
}

// 正确写法（函数内部读取）
export async function getStaticPaths() {
  const uri = process.env.MONGODB_URI;
  if (!uri) throw new Error("MONGODB_URI环境变量未配置");
  
  const client = await MongoClient.connect(uri);
  // 后续路径生成逻辑
}

其他可能的修复方案 #

• 清理构建缓存：如果之前硬编码过URI，缓存可能导致旧值残留，执行：

  rm -rf .next
  npm run build --no-cache
  

• 移除手动dotenv加载：Next.js会自动加载.env.local，如果代码里有require('dotenv').config()之类的手动加载逻辑，删除它避免冲突
• 升级Next.js版本：旧版本（比如9.x）对getStaticPaths的环境变量支持存在缺陷，升级到13+或14+的稳定版

调试方法 #

在getStaticPaths里打印环境变量，确认加载情况：

export async function getStaticPaths() {
  console.log("getStaticPaths环境变量:", process.env);
  // 其他逻辑
}

运行npm run dev或npm run build，查看控制台输出，确认MONGODB_URI是否存在。

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