Node.js集成Mailgun EU域名触发401未授权错误

针对你遇到的Node.js集成Mailgun EU域名时的401错误，以下是几个关键排查点和解决方法：

1. 确认API密钥的区域匹配 #

Mailgun的EU区域和US区域使用独立的API密钥，即使你确认密钥格式正确，也要确保它是EU区域账户生成的密钥，而非US区域的。登录Mailgun后台，进入EU区域的账户，复制对应的API密钥替换当前的MAILGUN_SECRET_KEY。

2. 检查域名归属的区域 #

确保你的验证域名是在EU区域的Mailgun账户下创建的，而非US区域。如果域名归属US账户，即使调用EU接口，也会触发权限校验失败。

3. 验证环境变量的正确性 #

在代码中添加日志，确认环境变量是否正确加载：

constructor() {
    this.apiKey = process.env.MAILGUN_SECRET_KEY;
    this.domain = process.env.MAILGUN_DOMAIN;
    // 添加日志验证配置是否加载成功
    console.log('API Key 状态:', this.apiKey ? '已加载' : '未找到');
    console.log('当前使用域名:', this.domain);
    this.mailgunClient = this.setupClient();
}

检查输出是否符合预期，避免因.env文件路径错误、变量名拼写错误导致的配置加载失败。

4. 确保发件人地址合规 #

from字段必须使用Mailgun验证过的域名下的邮箱地址，例如：

from: "你的应用 <noreply@your-verified-domain.com>"

使用未验证的外部邮箱地址可能触发权限校验失败。

5. 用curl直接测试API接口 #

排除代码层面的问题，用curl直接调用EU接口测试：

curl -s --user 'api:你的EU API密钥' https://api.eu.mailgun.net/v3/你的验证域名/messages \
-F from='测试发件人 <noreply@你的验证域名>' \
-F to='收件人邮箱地址' \
-F subject='测试邮件' \
-F text='测试内容'

如果curl请求同样返回401，说明问题出在账户/密钥/域名的区域匹配上；如果curl成功，则需要检查代码中的客户端配置是否有遗漏。

额外检查客户端配置 #

你的setupClient方法中URL配置正确，但可以确认是否存在版本兼容问题，确保mailgun.js和form-data是最新版本：

npm update mailgun.js form-data

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