基于 Django 构建 RESTful WebAPI 项目实战
一、创建 Django 项目
起步阶段,确保环境中已安装 Django。若未安装,可通过 pip 进行部署:
pip install django
初始化项目结构,生成主配置目录与首个应用:
django-admin startproject myproject
cd myproject
python manage.py startapp myapp
此时目录结构已就绪,接下来需要引入必要的依赖库。
二、安装相关依赖
构建 WebAPI 通常需要额外的库支持。例如 DRF(Django REST Framework)用于接口序列化,以及处理认证和缓存的工具包。建议将依赖写入 requirements.txt 以便管理:
pip install djangorestframework djangorestframework-simplejwt redis drf-yasg
三、配置 MySQL 数据库
默认 SQLite 适合开发,生产环境建议使用 MySQL。需在 settings.py 中调整 DATABASES 配置,指定 ENGINE、NAME、USER 等参数,并安装对应的驱动:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'your_db_name',
'USER': 'your_username',
'PASSWORD': 'your_password',
'HOST': 'localhost',
'PORT': '3306',
}
}
四、配置 Redis 缓存
引入 Redis 可显著提升接口响应速度。在 settings.py 的 CACHES 中添加 Redis 后端配置,并设置合理的过期策略:
CACHES = {
"default": {
"BACKEND": "django_redis.cache.RedisCache",
"LOCATION": "redis://127.0.0.1:6379/1",
"OPTIONS": {
"CLIENT_CLASS": "django_redis.client.DefaultClient",
}
}
}
五、配置 JWT 中间件
现代 API 多采用无状态认证。集成 JWT 后,用户登录获取 Token,后续请求携带 Token 即可验证身份,无需维护 Session。在 settings.py 中配置 REST_FRAMEWORK 及 JWT 相关参数:


