Flask框架集成SQLAlchemy连接MySQL数据库实战指南

Alice

发布时间：2026-10-13 | 5人浏览过

原创

本文详解Flask框架中利用SQLAlchemy ORM连接MySQL数据库的完整流程。涵盖pymysql依赖配置、app初始化、模型定义及通过flask_script执行数据保存与查询命令，提供可直接运行的代码示例。

本文详细介绍在Flask框架中利用ORM（对象关系映射）连接数据库的具体实现方法，供读者参考学习。

注意：在开始之前，请确保已安装flask_sqlalchemy库。鉴于python-mysql模块不兼容Python 3.6及以上版本，此处推荐使用pymysql作为替代驱动。

第一步，在Flask应用的主文件中添加以下配置代码：

该主文件命名为：learn_flask_mysql_orm.py

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
app = Flask(__name__)
app.config["SQLALCHEMY_DATABASE_URI"]="mysql+pymysql://root:@127.0.0.1:3306/learn_flask_mysql"
#注：请勿忘记添加'+pymysql'，否则将会出现没有安装mysqldb的报错
db = SQLAlchemy(app)
@app.route('/')
def hello_world():
  return 'Hello World!'
if __name__ == '__main__':
  app.run()

第二步，在Flask项目目录下新建一个名为models.py的文件，并在其中定义数据模型，代码如下：

from learn_flask_mysql_orm import db
class User(db.Model):
  __tablename__ = 'user'
  user_id = db.Column(db.INT,primary_key=True)
  user_name = db.Column(db.TEXT)
  def __init__(self,user_id,user_name):
    self.user_id = user_id
    self.user_name = user_name
  def __str__(self):
    return "id:{}  name:{}".format(self.user_id,self.user_name)

第三步，在Flask项目目录下新建一个名为manage.py的文件，用于处理命令行命令，代码如下：

from flask_script import Manager
from models import User
from learn_flask_mysql_orm import app,db
manager = Manager(app)
@manager.command
def save():
  user = User(11,'zhangjia11')
  db.session.add(user)
  db.session.commit()
@manager.command
def query_all():
  users = User.query.all()
  for user in users:
    print(user)
if __name__ == "__main__":
  manager.run()

完成上述配置后，运行python manage.py save命令即可将数据保存至数据库，执行python manage.py qurey_all命令则可查询所有数据。

如需了解更多Python相关技术，建议查阅本站专题：《Python常见数据库操作技巧汇总》、《Python数据结构与算法教程》、《Python函数使用技巧总结》、《Python字符串操作技巧汇总》、《Python入门与进阶经典教程》以及《Python文件与目录操作技巧汇总》。

希望本文提供的代码示例和操作步骤能对您的Python程序设计工作有所帮助。