Docker部署Django+PostgreSQL后创建超级用户遇UTF-8解码错误

1. 切换到容器内执行命令 #

你当前是在本地Python环境运行manage.py createsuperuser，但项目依赖和编码配置是基于Docker容器的，本地环境和容器环境不一致会导致PostgreSQL连接时的编码异常。正确操作是直接进入容器执行命令：

docker exec -it django_container python manage.py createsuperuser

2. 统一数据库名称配置 #

你的settings.py中数据库名称为firstproject，但docker-compose.yml里PostgreSQL的POSTGRES_DB设为project，两者不匹配会引发底层连接异常，需要统一：

• 方案一：修改docker-compose.yml中postgres_db的环境变量

  environment:
    - POSTGRES_DB=firstproject
    - POSTGRES_USER=postgres
    - POSTGRES_PASSWORD=postgres
  

• 方案二：修改settings.py中的NAME字段为project

3. 强制PostgreSQL以UTF-8编码初始化 #

在docker-compose.yml的postgres_db服务中添加编码初始化参数，确保数据库创建时使用UTF-8编码：

postgres_db:
  image: postgres
  volumes:
    - postgres_data:/var/lib/postgresql/data
  ports:
    - '5432:5432'
  environment:
    - POSTGRES_DB=firstproject
    - POSTGRES_USER=postgres
    - POSTGRES_PASSWORD=postgres
    - POSTGRES_INITDB_ARGS="--encoding=UTF8 --lc-collate=C --lc-ctype=C"
  container_name: postgres_db

4. 在Django配置中指定客户端编码 #

修改settings.py的数据库配置，添加OPTIONS强制客户端使用UTF8编码：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'firstproject',
        'PASSWORD': 'postgres',
        'USER':'postgres',
        'HOST': 'postgres_db',
        'PORT': 5432,
        'OPTIONS': {
            'client_encoding': 'utf8',
        },
    }
}

5. 清理旧数据卷并重新构建 #

如果之前的数据库卷是用错误编码创建的，需要彻底清理后重新初始化：

# 停止服务并删除数据卷
docker-compose down -v
# 重新构建并启动服务
docker-compose up --build

完成以上操作后，再次进入容器执行创建超级用户命令即可解决问题。

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