部署Next.js应用到Vercel时MONGODB_URI环境变量报错求助

针对你遇到的Invalid/Missing environment variable: "MONGODB_URI"和页面数据收集失败的错误，按以下步骤排查：

1. 在Vercel后台配置环境变量 #

本地的.env.local文件不会被上传到Vercel（默认在.gitignore中），必须手动在Vercel后台添加：

• 打开Vercel控制台，进入你的项目
• 切换到Settings → Environment Variables选项卡
• 点击Add，输入变量名MONGODB_URI，值填写你本地.env.local中替换了<username>和<password>的完整MongoDB链接
• 确保变量应用到Production环境（或勾选All Environments）

2. 检查MongoDB Atlas的网络权限 #

如果变量配置正确但仍报错，可能是MongoDB拒绝了Vercel的访问：

• 登录MongoDB Atlas，进入你的集群
• 点击左侧菜单Network Access
• 添加0.0.0.0/0（允许所有IP访问，适合生产部署场景），或者添加Vercel的官方IP段
• 确认你的数据库用户拥有对应数据库的读写权限

3. 验证代码中的变量引用 #

• 检查代码中是否正确使用process.env.MONGODB_URI，确保变量名拼写完全一致（大小写敏感）
• 如果你使用Next.js App Router，服务器组件直接调用process.env即可；如果是客户端组件需要访问该变量，需在变量名前添加NEXT_PUBLIC_前缀（但本次错误来自服务器端，此步骤可忽略）

4. 清理缓存重新部署 #

在Vercel的Deployments页面，点击对应部署记录的Redeploy，并勾选Clear build cache，确保新配置的环境变量生效

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