Django 1.11如何为所有数据表添加前缀以避免表名冲突

针对你遇到的Django内置表与遗留数据库表名冲突、无法使用多schema的问题，这里有两种实用方案帮你给所有Django表统一加上前缀，避免命名冲突：

一、使用第三方库（推荐） #

django-db-prefix是专门解决这类问题的插件，配置简单且能自动处理所有内置表和自定义模型表，步骤如下：

• 先安装库：

  pip install django-db-prefix
  

• 在项目的settings.py中做两处配置：
  1. 将库添加到INSTALLED_APPS：

     INSTALLED_APPS = [
         # 其他应用
         'django_db_prefix',
     ]
     

  2. 设置你想要的表前缀（比如用django_区分Django相关表）：

     DB_PREFIX = 'django_'
     

• 完成配置后，无论是Django自带的auth、session、admin表，还是你自己定义的模型表，生成时都会自动带上这个前缀，无需手动修改每个模型，省心高效。

二、手动配置（无需第三方依赖） #

如果不想引入第三方库，也可以通过自定义路由或修改模型Meta类实现：

方法1：自定义数据库路由 #

创建一个数据库路由类，统一处理表名前缀：

# 在你的应用下创建db_router.py文件
class PrefixRouter:
    def db_for_read(self, model, **hints):
        return 'default'

    def db_for_write(self, model, **hints):
        return 'default'

    def allow_relation(self, obj1, obj2, **hints):
        return True

    def allow_migrate(self, db, app_label, model_name=None, **hints):
        return True

    def table_name(self, model):
        # 自定义前缀，根据需要修改
        prefix = 'django_'
        return f"{prefix}{model._meta.db_table}"

然后在settings.py中注册这个路由：

DATABASE_ROUTERS = ['your_app_name.db_router.PrefixRouter']

这个方法能批量处理所有表，但要注意适配你的Django版本，部分旧版本可能需要调整路由逻辑。

方法2：逐个修改模型的db_table属性 #

对于自定义模型，直接在Meta类中指定带前缀的表名：

class MyCustomModel(models.Model):
    # 你的字段定义
    title = models.CharField(max_length=100)

    class Meta:
        db_table = 'django_my_custom_model'

但Django内置的auth、admin等表需要继承重写才能修改表名，比如自定义用户模型：

from django.contrib.auth.models import AbstractUser

class CustomUser(AbstractUser):
    class Meta(AbstractUser.Meta):
        db_table = 'django_user'

然后在settings.py中指定自定义用户模型：

AUTH_USER_MODEL = 'your_app_name.CustomUser'

这种方法适合只需要修改少量表的场景，但如果要覆盖所有内置表，工作量会比较大，不如第三方库高效。

关键注意事项 #

• 前缀要选择和遗留系统表名完全不冲突的命名，比如用项目缩写或django_这类明确标识的前缀；
• 配置完成后，记得重新生成并执行迁移文件，确保新表名生效；
• 如果已经有现有迁移文件，建议清理后重新生成，避免旧表名残留导致的冲突。

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