Flask-SQLAlchemy Core绑定SQL动态参数报错，请求协助排查

1. 先确认POST参数的获取逻辑 #

首先要保证从POSTMAN发送的请求参数能被Flask正确接收：

• 若用form-data传参，用request.form.get()获取；若用JSON格式，用request.get_json()解析
• 必须先校验参数是否存在，避免传入None导致绑定失败

示例代码：

from flask import Flask, request
from sqlalchemy import text
from werkzeug.security import check_password_hash

app = Flask(__name__)
# 假设已完成SQLAlchemy engine的配置

@app.route('/verify-user', methods=['POST'])
def verify_user():
    # 从form-data取参数（JSON请求则用下方注释的代码）
    user_name = request.form.get('user_name')
    password = request.form.get('password')
    
    # JSON请求的参数获取方式
    # req_data = request.get_json()
    # user_name = req_data.get('user_name')
    # password = req_data.get('password')

    # 先校验参数完整性
    if not user_name or not password:
        return "用户名或密码不能为空", 400

2. 正确绑定参数到SQL查询 #

使用text()构造查询语句时，占位符（如:user_name）必须和执行查询时传入的参数字典键名完全一致，否则会触发绑定参数缺失错误：

# 构造带占位符的查询语句
    query = text("SELECT id, user_name, password_hash FROM users WHERE user_name = :user_name")
    
    # 执行查询，传入键名匹配的参数字典
    with app.engine.connect() as conn:
        result = conn.execute(query, {"user_name": user_name})
        user = result.fetchone()

    if not user:
        return "用户不存在", 404

3. 哈希密码的验证逻辑 #

因为密码存储的是哈希值，不能直接和明文对比，要用对应的哈希工具验证：

# 用werkzeug的check_password_hash验证哈希密码
    if check_password_hash(user[2], password):  # user[2]对应password_hash字段
        return "验证通过", 200
    else:
        return "密码错误", 401

常见错误排查点 #

• 参数键名不匹配：查询里写的是:user_name，但传参字典用了username（少下划线），导致找不到绑定值
• POST参数传递错误：POSTMAN里参数名拼写错误（比如写成username），或者没传user_name参数，导致后端拿到None
• 查询语句占位符写错：比如把:user_name写成:username，和参数字典键不匹配
• 参数传递方式错误：执行查询时没把参数放在字典里，或用了位置参数而非关键字参数

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