本地Ubuntu虚拟机ERPNext LDAP登录报错：User with email: None不存在

• LDAP属性映射检查
  确认LDAP配置里的Email Field对应的LDAP属性是否正确，Windows AD中邮箱属性通常是mail，如果填成了不存在的属性（比如email），会导致Frappe无法获取邮箱值，出现email: None的错误。同时检查Username Field的映射是否正确，确保能读取到LDAP用户的标识字段（比如sAMAccountName）。

• LDAP用户属性存在性验证
  用LDAP查询工具验证目标用户的mail属性是否有有效值：

  • Ubuntu上可执行命令：ldapsearch -x -H ldap://<AD服务器IP> -D "<绑定用户DN>" -w "<绑定密码>" -b "<用户OU路径>" "(sAMAccountName=<用户名>)" mail，查看返回结果中是否包含mail: xxx@xxx.com的条目。
  • Windows上可使用ADSI Edit查看用户属性，确认mail字段已配置。

• Frappe LDAP自动创建用户配置检查
  检查LDAP设置中Create User if not exists是否开启，若未开启且系统中无匹配邮箱的用户，就会触发报错。即使开启，若First Name Field、Last Name Field等必填用户属性映射错误或为空，也会导致用户创建失败，进而出现邮箱不存在的提示。

• 版本兼容性验证
  当前使用ERPNext v14开发版搭配Frappe Framework v15开发版，跨大版本的开发版组合可能存在兼容性问题。建议尝试切换到同大版本的稳定版（如ERPNext v14 + Frappe v14）测试，排查是否是版本不兼容导致的LDAP逻辑异常。

• LDAP绑定用户权限排查
  确认配置的LDAP绑定用户是否有读取用户mail等属性的权限。若绑定用户权限不足，Frappe查询用户属性时会返回空值，导致邮箱为None。可通过绑定用户登录LDAP管理工具，尝试查看目标用户的属性，验证是否能正常读取邮箱字段。

• Frappe日志分析
  查看Frappe的LDAP相关日志，路径通常为/home/frappe/frappe-bench/logs/frappe.log，搜索LDAP或email关键字获取详细错误信息：

  • 执行命令：grep -i "ldap\|email" /home/frappe/frappe-bench/logs/frappe.log | tail -20，查看是否有属性查询失败、字段映射错误的记录。

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