Django 5.1.2升级后AppConfig.ready()数据库访问警告解决咨询

升级Django到5.1.2版本后，启动服务器时持续收到以下警告：

RuntimeWarning: Accessing the database during app initialization is discouraged. To fix this warning, avoid executing queries in AppConfig.ready() or when your app modules are imported.

经排查，警告来自apps.py中AppConfig.ready()方法内的数据库查询操作，原代码如下：

from django.apps import AppConfig


class TenantsConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'tenants'

    def ready(self):
        self.load_additional_databases()

    def load_additional_databases(self):
        from django.conf import settings

        from .models import DatabaseConfig

        for config in DatabaseConfig.objects.all():
            if config.name not in settings.DATABASES:

                db_settings = settings.DATABASES['default'].copy()

                db_settings.update({
                    'ENGINE': config.engine,
                    'NAME': config.database_name,
                    'USER': config.user,
                    'PASSWORD': config.password,
                    'HOST': config.host,
                    'PORT': config.port,
                })

                settings.DATABASES[config.name] = db_settings

我的settings.py中已硬编码default和tenants两个主数据库，需要在服务器启动时从DatabaseConfig模型读取数据，动态添加其他数据库配置。目前找到的解决方案是使用connection_created信号，但该信号会在每次数据库查询时触发，实现代码如下：

def db_config(**kwargs):
    from django.conf import settings

    from .models import DatabaseConfig

    for config in DatabaseConfig.objects.all():
        if config.name not in settings.DATABASES:

            db_settings = settings.DATABASES['default'].copy()

            db_settings.update({
                'ENGINE': config.engine,
                'NAME': config.database_name,
                'USER': config.user,
                'PASSWORD': config.password,
                'HOST': config.host,
                'PORT': config.port,
            })

            settings.DATABASES[config.name] = db_settings


class TenantsConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'tenants'

    def ready(self):
        connection_created.connect(db_config)

现咨询两个问题：

1. 是否有其他方式实现原ready()方法仅在启动时执行的行为？
2. 保留原方式忽略警告是否存在风险？（注：根据官方文档，该行为需避免但并非绝对有害，此处仅更新settings.py，未使用save()或delete()方法）

问题解答 #

1. 替代方案：仅在启动时执行动态数据库配置 #

推荐两种能实现「仅启动时执行」的方案：

方案一：自定义启动命令

扩展Django自带的runserver命令，在启动服务器前先加载数据库配置：

• 在你的tenants应用下创建management/commands/runserver_with_db.py文件：

from django.core.management.commands.runserver import Command as RunserverCommand
from django.conf import settings
from tenants.models import DatabaseConfig

class Command(RunserverCommand):
    def handle(self, *args, **options):
        # 加载额外数据库配置
        for config in DatabaseConfig.objects.all():
            if config.name not in settings.DATABASES:
                db_settings = settings.DATABASES['default'].copy()
                db_settings.update({
                    'ENGINE': config.engine,
                    'NAME': config.database_name,
                    'USER': config.user,
                    'PASSWORD': config.password,
                    'HOST': config.host,
                    'PORT': config.port,
                })
                settings.DATABASES[config.name] = db_settings
        # 调用原runserver逻辑
        super().handle(*args, **options)

之后启动服务器时执行python manage.py runserver_with_db，配置只会在启动时加载一次。

方案二：生产环境启动脚本前置初始化

如果是用uWSGI/Gunicorn等生产服务器，可以修改启动脚本，先完成Django初始化再加载配置：

import django
from django.conf import settings

# 初始化Django环境
django.setup()

# 加载数据库配置
from tenants.models import DatabaseConfig
for config in DatabaseConfig.objects.all():
    if config.name not in settings.DATABASES:
        db_settings = settings.DATABASES['default'].copy()
        db_settings.update({
            'ENGINE': config.engine,
            'NAME': config.database_name,
            'USER': config.user,
            'PASSWORD': config.password,
            'HOST': config.host,
            'PORT': config.port,
        })
        settings.DATABASES[config.name] = db_settings

# 启动WSGI应用
from django.core.wsgi import get_wsgi_application
application = get_wsgi_application()

将这个脚本作为uWSGI/Gunicorn的入口文件，配置只会在服务器启动时执行一次。

2. 保留原方式忽略警告的风险 #

即便你只是读库更新配置，没有写操作，仍有几个潜在风险：

• 初始化顺序问题：ready()阶段Django的数据库连接池可能未完全就绪，多进程/多线程环境下（比如uWSGI多worker），可能出现部分worker加载不到配置的情况。
• 版本兼容性问题：Django官方明确不推荐初始化阶段访问数据库，后续版本可能把警告升级为错误，导致代码直接无法运行。
• 测试干扰：运行测试时，Django会重置数据库状态，ready()中的查询可能打乱测试初始化流程，导致用例失败。

如果暂时不想改代码，可以在apps.py开头加import warnings; warnings.filterwarnings("ignore", category=RuntimeWarning)忽略警告，但不建议长期这么做。

内容的提问来源于stack exchange，提问作者Zedh