Node.js应用部署至Heroku后Mailgun无法识别apiKey凭证问题

你本地的 .env 文件通常会被加入 .gitignore 避免敏感信息泄露，因此不会被推送到 Heroku 服务器，Heroku 也不会主动读取本地 .env 中的配置，导致 process.env.MAILGUN_API_KEY 为空，触发报错。

方法1：通过Heroku后台配置 #

• 登录Heroku控制台，进入对应应用的「Settings」页面
• 找到「Config Vars」模块，点击「Reveal Config Vars」
• 新增两条配置：
  • 键：MAILGUN_API_KEY，值为你实际的Mailgun API密钥
  • 键：DOMAIN，值为你绑定的Mailgun域名
• 保存后重启应用即可生效

方法2：通过Heroku CLI配置 #

如果本地已安装Heroku命令行工具，在项目根目录直接执行以下命令：

heroku config:set MAILGUN_API_KEY=你的Mailgun密钥
heroku config:set DOMAIN=你的域名

执行完成后可通过 heroku config 命令验证配置是否正确。

• 调整dotenv加载逻辑，仅在本地开发环境加载，避免生产环境无效调用：

// 仅非生产环境加载dotenv
if (process.env.NODE_ENV !== 'production') {
  require('dotenv').config();
}

• 新增环境变量校验，提前发现配置缺失问题：

// MAILGUN INFO
const api_key = process.env.MAILGUN_API_KEY;
const domain = process.env.DOMAIN;
if (!api_key || !domain) {
  throw new Error('Mailgun必要环境变量缺失，请检查当前环境配置');
}
const mailgun = require('mailgun-js')({apiKey: api_key, domain: domain});

• 如果你仅在本地开发时使用dotenv，可以将dotenv放在devDependencies中，Heroku生产环境不需要依赖dotenv即可读取内置的Config Vars配置。

内容的提问来源于stack exchange，提问作者Leon Smith Jr.