本地能运行，为什么部署后提示环境变量缺失？

本地 .env 不会自动进入部署平台。部署时要为 Preview 与 Production 分别配置变量，确认变量是在构建时还是运行时读取，并在保存后重新部署。

推荐步骤

• 对照 .env.example 列出必需变量。

• 在平台为不同环境分别配置，核对大小写。

• 重新部署并查看构建日志与运行日志。

• 上线后做核心页面和接口 smoke test。

示例

if (!process.env.DATABASE_URL) {
  throw new Error("DATABASE_URL is missing");
}

常见误区

• 前端可见的环境变量默认应视为公开，不要放数据库密码或服务端 Token。