Python 项目实战：用 Flask 实现 MySQL 数据库增删改查 API

在 Python Web 开发领域，Flask 以其简洁、灵活的特性深受开发者喜爱。本文将手把手带你完成一个经典实战项目：使用 Flask 框架构建一套完整的 RESTful API，实现对 MySQL 数据库的基本增删改查操作。

一、项目初始化与依赖安装

首先，创建一个项目目录并安装必要的库。除了 Flask 本身，我们还需要连接 MySQL 的驱动。这里使用 PyMySQL 和用于管理数据库连接的 Flask-SQLAlchemy。

bash

pip install flask flask-sqlalchemy pymysql

核心依赖的作用：

flask: Web 框架核心。

flask-sqlalchemy: 一个强大的 ORM 库，能让我们用 Python 类来操作数据库，无需编写复杂的 SQL 语句，同时提供连接池管理。

pymysql: MySQL 数据库的 Python 驱动程序。

二、配置数据库连接与应用初始化

创建一个名为 app.py 的文件，进行基础配置。

python

from flask import Flask, request, jsonifyfrom flask_sqlalchemy import SQLAlchemy app = Flask(__name__)# 配置数据库连接地址app.config['SQLALCHEMY_DATABASE_URI']='mysql+pymysql://username:password@localhost:3306/flask_db'# 动态追踪修改，可关闭以节省性能app.config['SQLALCHEMY_TRACK_MODIFICATIONS']=False# 初始化数据库对象db = SQLAlchemy(app)

请将 username, password, flask_db 替换为你自己的 MySQL 用户名、密码和数据库名。

三、定义数据模型

我们以一个简单的 User 模型为例，它对应数据库中的一张 user 表。

python

classUser(db.Model):id= db.Column(db.Integer, primary_key=True) username = db.Column(db.String(80), unique=True, nullable=False) email = db.Column(db.String(120), unique=True, nullable=False)defto_dict(self):"""将对象转换为字典，方便后续序列化为 JSON"""return{'id': self.id,'username': self.username,'email': self.email}# 在首次运行时创建所有表with app.app_context(): db.create_all()

db.create_all() 会在应用上下文中根据模型创建数据表。

四、实现 CRUD API 路由

现在，我们来实现五个核心的 API 端点。

Create - 创建新用户

python

@app.route('/users', methods=['POST'])defcreate_user(): data = request.get_json()# 从请求体中获取 JSON 数据 new_user = User(username=data['username'], email=data['email']) db.session.add(new_user) db.session.commit()return jsonify(new_user.to_dict()),201# 201 表示创建成功

Read - 获取用户列表

python

@app.route('/users', methods=['GET'])defget_all_users(): users = User.query.all()return jsonify([user.to_dict()for user in users])

Read - 获取单个用户

python

@app.route('/users/<int:user_id>', methods=['GET'])defget_user(user_id): user = User.query.get_or_404(user_id)# 如果找不到则返回 404return jsonify(user.to_dict())

Update - 更新用户信息

python

@app.route('/users/<int:user_id>', methods=['PUT'])defupdate_user(user_id): user = User.query.get_or_404(user_id) data = request.get_json() user.username = data.get('username', user.username) user.email = data.get('email', user.email) db.session.commit()return jsonify(user.to_dict())

Delete - 删除用户

python

@app.route('/users/<int:user_id>', methods=['DELETE'])defdelete_user(user_id): user = User.query.get_or_404(user_id) db.session.delete(user) db.session.commit()return'',204# 204 表示成功处理，但无返回内容

五、运行与测试

在文件末尾添加：

python

if __name__ =='__main__': app.run(debug=True)

使用命令 python app.py 启动开发服务器。然后，你可以使用 Postman 或 curl 等工具来测试 API：

POST http://127.0.0.1:5000/users 创建用户。

GET http://127.0.0.1:5000/users 获取所有用户。

GET http://127.0.0.1:5000/users/1 获取 ID 为 1 的用户。

PUT http://127.0.0.1:5000/users/1 更新用户信息。

DELETE http://127.0.0.1:5000/users/1 删除用户。

总结与进阶

通过这个项目，你已经掌握了 Flask + MySQL 实现 CRUD API 的核心流程。在此基础上，可以进一步探索：

数据验证：使用 Flask-WTF 或 marshmallow 库来验证客户端传入的数据。

错误处理：为 404、500 等错误定制 JSON 格式的返回信息。

身份认证：使用 Flask-JWT-Extended 为 API 添加 JWT 认证。

项目结构优化：使用蓝本来模块化组织大型应用。

更多相关技术内容咨询欢迎前往并持续关注好学星城论坛了解详情。

想高效系统的学习Python编程语言，推荐大家关注一个微信公众号：Python编程学习圈。每天分享行业资讯、技术干货供大家阅读，关注即可免费领取整套Python入门到进阶的学习资料以及教程，感兴趣的小伙伴赶紧行动起来吧。

发表于 2025-09-27 09:26
阅读 ( 35 )
分类：Python开发

Python 项目实战：用 Flask 实现 MySQL 数据库增删改查 API

你可能感兴趣的文章

相关问题

0 条评论

作家榜 »