Django migrate默认操作却尝试连接非默认数据库的原因排查

这不是Django的Bug，而是它的设计行为，我来给你拆解原因和解决方案：

问题根源 #

虽然官方文档说migrate默认只操作默认数据库，但Django在执行migrate的初始化阶段，会尝试建立所有配置在DATABASES里的数据库连接——这是为了：

• 加载并验证所有数据库路由（Database Router）的规则
• 确认所有数据库后端的可用性，避免后续操作中出现意外
• 识别哪些模型属于哪个数据库（如果有跨库模型的话）

哪怕你没有对external_db做任何迁移操作，只要它出现在settings.py的DATABASES字典里，Django就会尝试建立连接，这就是你遇到连接错误的原因。

解决方案 #

根据你的场景（external_db是只读的，本地开发不需要连接它），可以用以下几种方法解决：

1. 本地开发环境动态控制数据库配置 #

通过环境变量或者本地配置文件，让external_db只在需要的环境（比如生产、测试）中加载，本地开发时跳过：

# settings.py
import os

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'mydatabase',
        'USER': 'myuser',
        'PASSWORD': 'mypassword',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

# 仅当环境变量开启时，添加外部数据库配置
if os.getenv('ENABLE_EXTERNAL_DB') == 'true':
    DATABASES['external_db'] = {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'myexternaldb',
        'USER': 'myexternaluser',
        'PASSWORD': 'myexternalpassword',
        'HOST': '10.10.10.10',
        'PORT': '3306',
        'OPTIONS': {
            'init_command': "SET sql_mode='STRICT_TRANS_TABLES'"
        }
    }

本地开发时，你可以不设置ENABLE_EXTERNAL_DB环境变量，这样Django就不会尝试连接external_db了。

2. 配置数据库路由禁止external_db的迁移操作 #

创建一个数据库路由类，明确告诉Django不要在external_db上执行任何迁移，同时限制模型的读写路由：

# 在你的app下创建db_router.py
class ExternalDBRouter:
    def db_for_read(self, model, **hints):
        # 只有指定的模型才走external_db读取
        if model._meta.app_label == 'your_app' and model.__name__ == 'YourExternalModel':
            return 'external_db'
        return 'default'

    def db_for_write(self, model, **hints):
        # 外部库是只读的，所有写操作都走默认数据库
        return 'default'

    def allow_migrate(self, db, app_label, model_name=None, **hints):
        # 禁止在external_db上执行任何迁移
        if db == 'external_db':
            return False
        # 允许默认数据库的所有迁移
        return True

然后在settings.py中添加路由配置：

DATABASE_ROUTERS = ['your_app.db_router.ExternalDBRouter']

这种方法可以阻止Django在external_db上执行迁移，但还是会尝试建立连接。如果本地无法连接外部数据库，还是推荐第一种方法。

3. 使用本地测试数据库替代external_db #

如果本地需要测试外部库的逻辑，可以在本地搭建一个MySQL测试库，把external_db的配置改成本地测试库的信息，这样既能正常连接，又不会影响生产数据。

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