Rails 7中Devise+LDAP登录异常：用户名登录提示邮箱格式错误

1. 修复登录视图的输入框类型 #

你在登录视图里错误使用了email_field渲染:username字段：

<%= f.email_field :username, autofocus: true, autocomplete: "username" %>

email_field会触发浏览器原生的邮箱格式校验（强制要求包含@符号），这就是Chrome弹出提示的直接原因。将其改为普通文本输入框即可解决：

<%= f.text_field :username, autofocus: true, autocomplete: "username" %>

2. 移除User模型中不必要的邮箱验证 #

Devise默认会给User模型添加邮箱相关的校验规则，即便启用LDAP登录也可能残留。在User模型里显式禁用邮箱校验：

class User < ApplicationRecord
  devise :ldap_authenticatable, :trackable, :timeoutable
  enum role: {logged_in: 0, reader: 1, regular: 2, moderator: 3, acceptor: 4, admin: 5}

  # 清除邮箱相关的默认验证
  validates :email, presence: false, uniqueness: false
end

如果你的User数据表不需要email字段，可以直接通过迁移移除该字段。

3. 完善Devise配置，彻底禁用邮箱登录相关逻辑 #

在devise.rb中补充以下配置，确保所有登录相关流程都以用户名作为核心字段：

Devise.setup do |config|
  # 已有的LDAP及基础配置...

  # 明确指定登录、密码重置的核心字段为用户名
  config.authentication_keys = [:username]
  config.reset_password_keys = [:username]
  config.case_insensitive_keys = [:username]
  config.strip_whitespace_keys = [:username]

  # 禁用邮箱格式校验规则
  config.email_regexp = nil
end

4. 确认参数过滤配置完整 #

你的SessionsController已配置允许:username参数，可补充完整登录所需的所有参数：

def configure_sign_in_params
  devise_parameter_sanitizer.permit(:sign_in, keys: [:username, :password, :remember_me])
end

验证效果 #

修改完成后重启Rails服务器，使用用户名登录时浏览器将不再提示@符号要求，LDAP会正常通过用户名完成授权验证。

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