ERPNext邮箱账户配置问题咨询:收件邮箱账户错误、域名不被接受及配置方法求助
解决ERPNext配置Gmail邮箱的报错问题
我来帮你搞定这个配置问题——首先得明确一个关键信息:Google早在2022年就彻底停用了「低安全应用访问」功能,所以你开启这个权限其实没用,这也是你出现报错的核心原因之一。咱们一步步来解决:
第一步:准备Gmail的App Password(替代低安全应用的正确方式)
要让ERPNext正常访问Gmail,你需要先开启两步验证(2FA),然后生成专门的App Password:
- 打开Gmail的「设置」→ 切换到「安全性」标签页
- 找到「两步验证」,按照向导完成开启(这是生成App Password的前提)
- 开启2FA后,回到安全性页面,找到「App Passwords」选项(只有开启2FA才会显示这个入口)
- 应用选择「Mail」,设备选择「Other (Custom name)」,输入比如「ERPNext」,点击生成,复制这个16位的密码(注意不要带空格,直接复制)
第二步:ERPNext中正确配置邮箱账户
进入ERPNext后台,找到「工作台」→「电子邮件」→「邮箱账户」→「新建」,按照以下参数填写:
收件邮件(Incoming)配置
- 邮箱地址:填写你的完整Gmail地址(比如
xxx@gmail.com) - 密码:粘贴刚才生成的App Password(不是你的Gmail登录密码!)
- IMAP服务器:
imap.gmail.com - 端口:
993 - 加密方式:选择「SSL/TLS」
- 勾选「启用收件服务器」
发件邮件(Outgoing)配置
- SMTP服务器:
smtp.gmail.com - 端口:
465(或者选587+STARTTLS,465的SSL/TLS更稳定) - 加密方式:「SSL/TLS」
- 密码:同样用刚才的App Password
- 勾选「启用发件服务器」
填完后点击「测试连接」,正常情况下就能成功了。
针对你遇到的两个错误的具体解决方案
1. “Incoming email account not correct”(收件邮箱账户错误)
- 最常见原因:用了Gmail的登录密码而不是App Password,立刻换成生成的16位密码试试
- 检查Gmail的IMAP功能是否开启:Gmail设置→「转发和POP/IMAP」→ 确保「IMAP访问」是「启用IMAP」状态
- 核对IMAP服务器和端口:必须是
imap.gmail.com+993,加密方式不能选错
2. “Email Domain not accepted”(邮箱域名不被接受)
- 先检查ERPNext的「电子邮件域名」列表:进入「电子邮件」→「电子邮件域名」,确认
gmail.com已经存在;如果没有,新建一个,域名填gmail.com,保存后再回到邮箱账户配置页面 - 确保你填写的邮箱地址是完整的(包含
@gmail.com),不要只填用户名部分
额外注意事项
- 如果你用的是Google Workspace(原G Suite)账户,配置逻辑类似,但可能需要联系管理员确认是否允许第三方应用使用App Password
- 不要尝试继续用「低安全应用访问」,Google已经彻底关闭了这个功能,开了也不会生效
- 如果测试连接还是失败,检查你的服务器网络是否能访问Gmail的IMAP/SMTP服务器(有些环境可能需要配置代理)
内容的提问来源于stack exchange,提问作者Vishal Patil




