Node.js中.env配置邮箱供nodemailer使用报错解决

问题复现 #

在Node.js项目中通过.env文件配置nodemailer发信参数时，出现三类异常表现：

• VSCode中编辑EMAIL字段输入@符号后直接抛出语法错误，代码运行时读取到的process.env.EMAIL为undefined
• 移除@gmail.com后缀后，编辑器会在邮箱字符串的数字位置标红报错
• 仅当配置完全不含数字的邮箱地址时，配置才能被正常解析

当前使用的错误配置内容如下：

// variables used for email
SERVICE=gmail
SERVICE_PORT=465
EMAIL= xxx.xxx.10@gmail.com
PASSWORD= nxxxxxxxxxx

问题根因 #

1. .env文件的标准语法仅支持#作为注释标识符，//属于非法注释写法，会被.env解析器、VSCode语法校验插件判定为语法错误，打断后续配置项的解析链路
2. 配置项等号和值之间多余的前置空格，会导致部分版本的dotenv解析库在识别含@、数字组合的特殊字符串时出现解析逻辑异常，最终返回undefined

修复步骤 #

• 替换非法注释：将所有//开头的注释行改为#开头，或直接删除冗余注释
• 清理格式冗余：删除所有配置项等号两侧的多余空格，保证键名=值的格式无多余空白字符
• 特殊字符兼容：如果值本身包含空格、特殊符号，可给值包裹半角双引号避免解析歧义

修复后的可用配置参考：

# variables used for email
SERVICE=gmail
SERVICE_PORT=465
EMAIL=xxx.xxx.10@gmail.com
PASSWORD="nxxxxxxxxxx"

配置修改完成后重启Node.js服务，即可正常读取到完整的邮箱参数值，VSCode中的语法报错也会同步消失。额外注意：Gmail账户的PASSWORD字段需填写谷歌账户生成的应用专用密码，不能使用日常登录密码，否则nodemailer会触发鉴权失败错误。

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