Pycharm下Django连接MySQL数据库，执行makemigrations后为何没有创建数据表？

在Pycharm环境下使用Django开发项目时，完成MySQL数据库配置后执行makemigrations命令，却没有在数据库中生成对应的数据表，是很多开发者都会遇到的典型问题。该问题的诱因较多，需要从配置、模型、迁移状态等多个维度逐一排查。

常见问题原因及排查方法

1. 数据库配置错误

首先需要检查Django项目的settings.py文件中数据库配置是否正确，错误的配置会导致Django无法正确连接MySQL，自然无法执行建表操作。

正确的MySQL配置示例如下：

# settings.py 数据库配置部分
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',  # 数据库引擎，必须正确
        'NAME': 'test_db',  # 要连接的MySQL数据库名称，需提前创建
        'USER': 'root',  # MySQL用户名
        'PASSWORD': '123456',  # 对应用户的密码
        'HOST': '127.0.0.1',  # MySQL服务地址，本地为127.0.0.1
        'PORT': '3306',  # MySQL默认端口
    }
}

排查时需要确认数据库名称是否存在、用户名密码是否正确、MySQL服务是否正常运行，同时检查是否安装了mysqlclient或者pymysql驱动，若使用pymysql还需要在项目初始化文件中添加适配代码：

# 项目主目录下的__init__.py文件
import pymysql
pymysql.install_as_MySQLdb()  # 让Django识别pymysql驱动

2. 模型未注册到应用

如果在models.py中定义了数据模型，但是没有在应用的apps.py和settings.py中完成注册，Django不会识别该模型，执行迁移命令也不会生成对应表。

首先确认应用的apps.py配置：

# 应用目录下的apps.py
from django.apps import AppConfig

class UserConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'user'  # 应用名称，需和目录名一致

然后在settings.py的INSTALLED_APPS中添加应用配置类或者应用名称：

# settings.py
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'user.apps.UserConfig',  # 注册自定义应用，也可直接写'user'
]

3. 迁移文件未生成或状态异常

makemigrations命令的作用是生成迁移文件，而不是直接创建数据表，生成迁移文件后还需要执行migrate命令才会真正操作数据库建表。如果只执行了makemigrations没有执行migrate，数据库中不会有表。

同时如果迁移文件已经存在，但是模型没有变更，再次执行makemigrations不会生成新的迁移文件，也不会触发建表。此时可以检查应用目录下的migrations文件夹，查看是否有对应模型的迁移文件，若迁移文件缺失可以删除该文件夹下所有带编号的文件（注意不要删除__init__.py），重新执行迁移命令。

4. 数据库中存在迁移记录冲突

Django会将迁移记录存储在django_migrations表中，如果该表中已经存在对应应用的迁移记录，但是实际的迁移文件被删除或者修改，会导致迁移命令执行异常，无法建表。此时可以登录MySQL数据库，查询django_migrations表：

-- 登录MySQL后执行
USE test_db;  -- 切换到项目使用的数据库
SELECT * FROM django_migrations WHERE app='user';  -- 查询指定应用的迁移记录

如果确认迁移文件有问题，可以删除对应应用的迁移记录，同时删除migrations文件夹下的迁移文件，重新执行makemigrations和migrate命令。

正确的迁移操作流程

在Pycharm下完成Django连接MySQL并创建数据表的标准流程如下：

• 第一步：安装MySQL驱动，配置settings.py中的数据库参数，确认MySQL服务正常运行，目标数据库已创建
• 第二步：在应用的models.py中定义数据模型，完成应用的注册
• 第三步：在Pycharm的Terminal终端执行python manage.py makemigrations命令，生成迁移文件
• 第四步：执行python manage.py migrate命令，将迁移文件同步到MySQL数据库，完成建表

如果执行完上述流程还是没有生成表，可以开启Django的SQL日志，查看迁移命令实际执行的SQL语句，进一步定位问题：

# settings.py 中添加日志配置
LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
        },
    },
    'loggers': {
        'django.db.backends': {
            'handlers': ['console'],
            'level': 'DEBUG',
        },
    },
}

开启日志后重新执行migrate命令，就可以在终端看到Django实际向MySQL发送的SQL语句，根据SQL语句的内容就能判断是配置问题还是执行异常问题。

DjangomakemigrationsMySQLPycharm修改时间：2026-07-14 17:45:27