NestJS集成Mailjet发邮件在K8s Pod中报getaddrinfo ENOTFOUND错误

算力阿峰

2026-10-5

问题根因定位方向&解决方案

你遇到的是典型的K8s环境下Node.js应用域名解析行为与系统工具不一致的问题，按以下优先级排查即可解决：

1. 优先排查配置读取异常

首先在邮件发送逻辑前打印实际读取到的host配置，确认从ConfigMap/Secret读取的mailerConfigService.host值没有多余的空格、换行、特殊字符：

console.log('Mail host config:', JSON.stringify(mailerConfigService.host));
// 正常输出应该是 "in-v3.mailjet.com"，如果前后带空格、引号、换行都会导致解析失败

此前有大量同类案例是K8s ConfigMap导出配置时不小心带了末尾换行，直接触发ENOTFOUND错误。

2. 修复K8s DNS搜索域匹配问题

K8s Pod默认resolv.conf的ndots参数为5，意味着少于5个点的域名会先尝试拼接集群搜索后缀（比如svc.cluster.local）再做公网解析，容易触发解析超时或者失败。
直接在host末尾加一个.标记为绝对域名，跳过集群搜索域匹配即可：

// 改配置为
host: mailerConfigService.host + '.', // 最终值为 in-v3.mailjet.com.

3. 强制IPv4解析

你nslookup返回的是IPv4地址，如果集群没有配置IPv6网络，Node.js默认优先解析IPv6的AAAA记录失败也会触发ENOTFOUND错误，在transport配置中强制指定IPv4解析：

transport: {
  host: mailerConfigService.host,
  secure: false,
  auth: {
    user: mailerConfigService.user,
    pass: mailerConfigService.password,
  },
  // 新增以下配置
  family: 4
},

4. 排查服务网格sidecar启动顺序问题

如果你的集群启用了Istio/Linkerd等服务网格，sidecar容器启动晚于业务容器时，业务容器刚启动阶段的DNS请求会被拦截失败，如果你的Mailer连接是应用启动时就初始化的，会永久报错。
可以给业务容器加启动探针，等待sidecar完全就绪后再启动业务逻辑，或者进入Pod手动重启Node进程验证是否恢复。

5. 验证Node.js层面DNS解析能力

如果以上步骤都无效，在应用中加代码测试Node.js原生DNS模块的解析结果，和系统nslookup结果对比：

const dns = require('dns');
// 和系统getaddrinfo行为一致，Nodemailer默认用这个方法
dns.lookup('in-v3.mailjet.com', (err, address) => {
  console.log('dns.lookup结果：', err, address);
});
// 直接走DNS请求，和nslookup行为一致
dns.resolve('in-v3.mailjet.com', (err, addresses) => {
  console.log('dns.resolve结果：', err, addresses);
});

如果dns.resolve正常但dns.lookup报错，可以在transport配置中强制指定DNS服务器规避：

transport: {
  // 原有配置保留
  dns: ['10.32.0.10', '8.8.8.8'] // 填你集群的DNS地址或者公共DNS
}

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