Flask登录功能异常：正确凭据无法登录求助

1. 密码哈希校验不匹配（最常见原因） #

核心检查注册逻辑是否正确生成密码哈希：

• 确认注册时使用generate_password_hash对明文密码加密后再存入数据库，示例代码：

from werkzeug.security import generate_password_hash

# 注册流程示例
new_user = Users(
    email=request.form['email'],
    pw_hash=generate_password_hash(request.form['password'])
)
db.session.add(new_user)
db.session.commit()

如果注册时直接存储明文密码，或哈希生成的算法/参数与check_pw_hash不兼容，会直接导致校验失败。

2. 用户查询逻辑存在漏洞 #

• 邮箱大小写问题：数据库中存储的邮箱可能是小写，但用户输入了大写，导致查询不到匹配用户。可统一处理为小写：

  users = Users.query.filter_by(email=email.lower())
  

  同时注册时也将邮箱转小写存储，从根源避免大小写差异。
• 重复邮箱数据：如果数据库中存在多个相同邮箱的用户（未加唯一约束），users.count() == 1的判断会不成立。需在Users模型中给邮箱字段添加唯一约束：

  email = db.Column(db.String(120), unique=True, nullable=False)
  

3. 表单数据接收异常 #

先在登录路由中打印表单数据，确认是否正确获取用户输入：

elif request.method == 'POST':
    print("表单数据:", request.form)  # 打印所有提交的表单字段
    email = request.form['email']
    password = request.form['password']
    # 后续逻辑...

若输出中没有email或password字段，检查前端表单的name属性是否拼写错误，或是否有JS代码拦截了表单提交。

4. 调试定位具体错误点 #

在登录路由中添加调试打印，精准定位失败环节：

elif request.method == 'POST':
    email = request.form['email']
    password = request.form['password']
    users = Users.query.filter_by(email=email)
    
    print(f"查询到用户数量: {users.count()}")
    if users.count() == 1:
        user = users.first()
        print(f"存储的密码哈希: {user.pw_hash}")
        print(f"密码校验结果: {check_pw_hash(password, user.pw_hash)}")
        if check_pw_hash(password, user.pw_hash):
            # 登录成功逻辑
        else:
            print("密码校验失败")
    else:
        print("未找到匹配邮箱的用户")
    # 后续逻辑...

通过打印信息可快速判断是用户不存在，还是密码校验失败。

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