Django连接MySQL数据库并获取数据的完整流程

小石头
小石头
发布时间:2026-10-15| 5人浏览过
原创

本文详细记录使用Django连接MySQL数据库并获取数据的完整步骤。内容涵盖项目与应用创建、数据库模块安装、settings配置、Model定义、数据库表创建、路由配置及视图函数编写。同时针对connect类型错误和Model未激活报错提供了具体的排查与解决方案,帮助开发者快速实现Django与MySQL的数据交互。

首先,需要创建Django项目。

在项目目录下执行相应的初始化命令来构建项目结构。

django-admin startproject myweb

接着,在项目中创建具体的应用模块。

python manage.py startapp myapp

完成基础设置后,启动项目服务以验证环境是否正常运行。

python manage.py runserver

若启动时未指定端口,系统将默认使用8080端口。建议手动指定端口号,以避免与其他运行中的项目发生端口冲突,确保服务能够成功启动。

python manage.py runserver 0.0.0.0:8080

端口号的选择具有灵活性,只要确保不与本地其他服务的端口重复即可。

接下来,配置Django以连接数据库。

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'mydemo',
        'USER': 'root',
        'PASSWORD': '',
        'HOST': 'localhost',
        'PORT': '3306',
    }
}

如果环境中尚未安装mysqlclient模块,需先执行安装命令进行依赖补充。

pip install  mysqlclient

随后,在应用目录中定义数据模型(Model)。

```python
from django.db import models

# Create your models here.

class Stu(models.Model):
    '''自定义Stu表对应的Model类'''
    #定义属性:默认主键自增id字段可不写
    id = models.AutoField(primary_key=True)
    name = models.CharField(max_length=16)
    age = models.SmallIntegerField()
    sex = models.CharField(max_length=1)
    classid=models.CharField(max_length=8)

    # 定义默认输出格式
    def __str__(self):
        return "%d:%s:%d:%s:%s"%(self.id,self.name,self.age,self.sex,self.classid)

    # 自定义对应的表名,默认表名:myapp_stu
    class Meta:
        db_table="stu"

最后一步是激活模型,即将新建的应用注册到项目的配置文件中,使其生效。

编辑myweb/settings.py文件,并将该虚线路径添加到该INSTALLED_APPS设置。

INSTALLED_APPS  =  [ 
    'django.contrib.admin' ,
    'django.contrib.auth' ,
    'django.contrib.contenttypes' ,
    'django.contrib.sessions' ,
    'django.contrib.messages' ,
    'django.contrib.staticfiles' ,
    'myapp.apps.MyappConfig',  #或者直接写 myapp
]

在代码层面配置完成后,需要在数据库服务端创建对应的数据库实例。

建议使用Navicat等数据库管理工具,在MySQL中创建名为myweb的数据库,并建立stu数据表。表结构需根据Django模型中定义的数据类型进行映射,并手动录入测试数据。

在数据库工具中录入数据时,字符串类型的值必须使用单引号包裹,否则可能导致语法错误。

在此过程中,可能会遇到一些常见的错误,需要逐一排查。

错误信息提示:TypeError: connect() argument 3 must be str, not int。

该错误源于类型不匹配,需确保数据库配置文件中字段的类型与代码定义的类型严格一致。

错误信息提示:RuntimeError: Model class myapp.models.Stu doesn’t declare an explicit app_label and isn’t in an app。

此错误表明模型未被正确激活。原因为应用名称配置错误,例如误写为myphoto而非myapp,导致Django无法识别应用标签。

配置完成后,进入应用开发阶段。

# 文件:myapp/views.py 文件代码

from django.shortcuts import render
from django.http  import HttpResponse
from myapp.models import Stu
# Create your views here.

def index(request):
    return HttpResponse("Hello Django!")

def stu(request):
    #获取所有stu表信息
    lists = Stu.objects.all()
    print(lists)
    #获取单条学生信息
    print(Stu.objects.get(id=1))

    return HttpResponse("ok")

需要在URL配置文件中为处理stu数据的视图函数设置访问路由。

#在myapp/urls.py文件中配置

path('stu/', views.stu),

配置好路由后,重新启动Django服务以加载最新配置。

python manage.py runserver

在浏览器或客户端中,将请求路径修改为配置好的路由地址。

http://127.0.0.1:8088/myapp/stu/

此时,查看命令行终端输出,应能看到从数据库读取到的数据打印信息。

最终,网页端成功显示从数据库中获取的数据内容。

对整个流程进行回顾与总结。

这是一个获取数据库内容的简易示例,核心关键在于必须先确保数据库中已存在对应数据,才能成功获取。

至此,关于Django连接数据库并获取数据的教程介绍完毕。如需了解更多相关内容,可搜索本站往期文章或继续浏览后续内容,感谢支持。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。