解决Django连接db遇到的问题

下面是解决 Django 连接数据库时可能遇到的问题的完整攻略,包含两个示例说明.

1. 安装数据库驱动程序

在使用 Django 连接数据库之前,需要先安装相应的数据库驱动程序.不同的数据库使用不同的驱动程序,下面以 MySQL 为例进行说明.

MySQL 驱动程序安装

安装 mysqlclient 库：

bash pip install mysqlclient

安装 mysql-connector-python 库：

bash pip install mysql-connector-python

安装 pymysql 库：

bash pip install pymysql

2. 配置 Django 数据库

在安装好数据库驱动程序之后,此时此刻呢需要配置 Django 的数据库参数.在项目目录下的 settings.py 文件中找到 DATABASES 参数,如果该参数不存在,则需要先创建.

MySQL 数据库配置示例

DATABASES = {
'default': {
    'ENGINE': 'django.db.backends.mysql',
    'NAME': 'demo',         # 数据库名称
    'USER': 'root',         # 数据库用户名
    'PASSWORD': 'root123',  # 数据库密码
    'HOST': 'localhost',    # 数据库地址
    'PORT': '3306',         # 端口号
}
}

SQLite 数据库配置示例

DATABASES = {
'default': {
    'ENGINE': 'django.db.backends.sqlite3',
    'NAME': 'db.sqlite3',
}
}

③ 执行数据库迁移

当 Django 连接数据库之后,需要执行数据库迁移操作,创建相关的数据表和字段.在项目目录下输入以下命令：

python manage.py makemigrations
python manage.py migrate

④ 测试连接数据库是否成功

在以上步骤完成后,可以通过以下方法测试 Django 是否成功连接到了数据库.

python manage.py shell

然后在 Python 命令行中输入以下命令：

from django.db import connection
connection.connect()       # 连接数据库
print(connection.is_usable())   # 输出 True 或 False,表示连接是否可用

如果输出了 True,则说明连接成功；如果输出了 False,则说明连接失败.

示例一

假设在连接 MySQL 数库时出现以下问题：

Command "/usr/bin/python③7 -u -c "import setuptools, tokenize;__file__='/tmp/pip-install-ihdrxxvz/mysqlclient/setup.py';
f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('\r\n', '\n');f.close();
exec(compile(code, __file__, 'exec'))" install --record /tmp/pip-record-xin7t3eu/install-record.txt 
--single-version-externally-managed --compile" failed with error code 1 in /tmp/pip-install-ihdrxxvz/mysqlclient/

解决：在这种情况下,可能是因为 MySQL 驱动程序没有正确安装引起的.可以尝试先卸载 mysqlclient 库,然后重新安装.

pip uninstall mysqlclient
pip install mysqlclient

示例二

假设在连接 SQLite 数据库时出现以下问题：

django.core.exceptions.ImproperlyConfigured: SQLite ③⑧3 or later is required (found ③⑦17).

wget https://sqlite.org/2022/sqlite-autoconf-3370000.tar.gz
tar xzf sqlite-autoconf-3370000.tar.gz
cd sqlite-autoconf-3370000/
./configure
make
make install

安装完毕后,重新执行数据库迁移即可.