使用.env文件配置Nodemailer时功能无法正常运行问题求助

按优先级从高到低排查以下问题：

1. 确认dotenv库已正确安装和加载 #

Node.js 默认不会自动读取.env文件，需要借助dotenv库完成配置加载：

• 安装依赖：

  npm install dotenv
  # 或使用yarn：yarn add dotenv
  # 或使用pnpm：pnpm add dotenv
  

• 在你使用process.env变量的代码文件最顶部添加加载代码，CommonJS 写法：

  require('dotenv').config()
  

  ES Module 写法：

  import dotenv from 'dotenv'
  dotenv.config()
  

2. 确认.env文件存放路径正确 #

dotenv 默认会读取当前执行命令的工作目录下的.env文件，也就是你项目的根目录（和package.json同级的位置）。
如果你的.env放在其他子目录，需要手动指定路径：

require('dotenv').config({ path: './src/.env' }) // 替换为你的.env实际路径

3. 端口号类型转换 #

.env中读取的所有值默认都是字符串类型，而nodemailer的port参数要求传入数字，直接传字符串会导致运行异常，修改代码如下：

const transporter = nodemailer.createTransport({
  host: process.env.HOST,
  port: Number(process.env.PORTEMAIL), // 转换为数字类型
  secure: true,
  auth: {
    user: process.env.USER,
    pass: process.env.PASSWORD,
  }
});

4. 检查.env文件格式是否正确 #

确保.env中配置项的等号两侧没有多余空格，值不需要加引号，避免空格或引号被识别为配置值的一部分导致认证失败：

# 正确写法
HOST=smtp.gmail.com
PORTEMAIL=465
USER=test@gmail.com
PASSWORD=123

# 错误写法示例
HOST = smtp.gmail.com # 等号两侧有空格
USER="test@gmail.com" # 值带多余引号

验证方法 #

可以在创建transporter之前添加日志打印，确认配置是否正确加载：

console.log('配置加载结果：', {
  host: process.env.HOST,
  port: process.env.PORTEMAIL,
  user: process.env.USER,
  pass: process.env.PASSWORD
})

如果打印结果为undefined，说明配置没有被正确加载，优先排查前两个问题；如果值和你写的.env内容不一致，排查第4个问题；如果值都正确但还是报错，排查第3个端口类型问题。

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