Python+Flask+MySQL创建API时数据库连接报错求助

我帮你梳理下这段Flask API代码里的数据库连接问题，几个核心问题和修复方案如下：

1. 修复finally块的资源释放逻辑 #

你的finally块直接调用cursor.close()和conn.close()，但如果数据库连接失败（比如mysql.connect()抛出异常），conn和cursor变量可能还没被初始化，这会触发新的异常，直接掩盖原本的数据库错误。应该先判断变量是否存在再执行关闭操作：

@app.route('/add', methods=['POST'])
def add_user():
    conn = None
    cursor = None
    try:
        _json = request.json
        _name = _json['name']
        _email = _json['email']
        _password = _json['pwd']
        # 验证接收参数
        if _name and _email and _password and request.method == 'POST':
            # 密码哈希处理
            _hashed_password = generate_password_hash(_password)
            # 插入SQL语句
            sql = "INSERT INTO user(user_name, user_email, user_password) VALUES(%s, %s, %s)"
            data = (_name, _email, _hashed_password,)
            conn = mysql.connect()
            cursor = conn.cursor()
            cursor.execute(sql, data)
            conn.commit()
            resp = jsonify('User added successfully!')
            resp.status_code = 200
            return resp
        else:
            return not_found()
    except Exception as e:
        # 将错误信息返回给客户端，方便调试
        resp = jsonify(f'Error details: {str(e)}')
        resp.status_code = 500
        return resp
    finally:
        # 先判断游标是否存在再关闭
        if cursor:
            try:
                cursor.close()
            except Exception as e:
                print(f"关闭游标失败: {str(e)}")
        # 再判断连接是否存在再关闭
        if conn:
            try:
                conn.close()
            except Exception as e:
                print(f"关闭数据库连接失败: {str(e)}")

2. 确认MySQL连接配置正确性 #

检查你的Flask应用是否正确配置了MySQL连接参数，示例配置如下：

app.config['MYSQL_HOST'] = 'localhost'  # 或远程数据库地址
app.config['MYSQL_USER'] = '你的数据库用户名'
app.config['MYSQL_PASSWORD'] = '你的数据库密码'
app.config['MYSQL_DB'] = '目标数据库名称'
app.config['MYSQL_PORT'] = 3306  # 默认端口，若修改过需对应调整

如果是远程数据库，还要确认服务器防火墙是否开放3306端口，以及数据库用户是否拥有目标库的读写权限。

3. 优化异常调试体验 #

原代码仅用print(e)输出错误，在服务器环境或生产场景下你可能看不到这个输出。改成将错误信息返回给客户端后，你可以直接通过API请求看到具体错误类型，比如：

• 数据库连接超时
• 用户权限不足
• 表名/字段名拼写错误（比如user表是否存在，user_name等字段是否与数据库定义一致）

额外优化建议 #

可以使用**上下文管理器（with语句）**自动管理数据库连接和游标，无需手动调用close，代码更简洁且安全：

# 替换原有的conn和cursor创建逻辑
with mysql.connect() as conn:
    with conn.cursor() as cursor:
        cursor.execute(sql, data)
        conn.commit()

这种写法下，即使发生异常，Python会自动帮你关闭游标和数据库连接，避免资源泄漏。

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