Django配置PostgreSQL自定义schema执行migrate报错如何解决

问题原因 #

你遇到的两个现象本质原因都是目标自定义schema未预先创建，或数据库账号无该schema的操作权限：

• 仅配置search_path=my_custom_schema时报错：PostgreSQL找不到可用的schema用于建表，直接抛出无选中schema的错误
• 追加public后表落入public：PostgreSQL会按search_path的顺序选择第一个有权限操作的schema，my_custom_schema不可用时自动 fallback 到public

解决步骤 #

步骤1：预先创建Schema并分配权限 #

首先登录PostgreSQL，切换到你Django配置中指定的数据库（注意不是默认的postgres库），执行以下SQL：

-- 创建自定义schema（如果不存在）
CREATE SCHEMA IF NOT EXISTS my_custom_schema;
-- 将schema的所有者设置为Django使用的数据库账号，替换为你配置的DB_USERNAME
ALTER SCHEMA my_custom_schema OWNER TO your_db_username;

如果需要更稳妥的兜底配置，可以直接修改该数据库账号的默认搜索路径，避免后续配置失效：

ALTER ROLE your_db_username SET search_path TO my_custom_schema;

步骤2：修正Django数据库配置 #

恢复为最初的配置，不需要在search_path中追加public：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': os.environ['DB_DATABASE'],
        'USER': os.environ['DB_USERNAME'],
        'PASSWORD': os.environ['DB_PASSWORD'],
        'HOST': os.environ.get('DB_HOST', 'localhost'),
        'PORT': os.environ.get('DB_PORT', '5432'),
        'OPTIONS': {
            'options': '-c search_path=my_custom_schema',
        },
    }
}

步骤3：执行迁移 #

如果你之前已经在public中生成过表，建议先清空public下的所有Django生成表，再执行迁移命令：

python manage.py migrate

执行完成后所有Django系统表和业务表都会自动创建在my_custom_schema下。

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