Django와 PostgreSQL에서 발생하는 "AssertionError: database connection isn't set to UTC" 오류 해결

2024-07-27

Django와 PostgreSQL에서 발생하는 "AssertionError: database connection isn't set to UTC" 오류 해결

오류 발생 원인

Django ORM은 날짜 및 시간 필드를 UTC 시간대로 저장하고 검색합니다. 반면, PostgreSQL은 기본적으로 서버의 로케일 설정에 따라 시간대를 설정합니다. 만약 서버의 로케일 설정이 UTC와 다르면 Django ORM과 PostgreSQL의 시간대 설정이 서로 충돌하여 오류가 발생하게 됩니다.

오류 해결 방법

다음은 "AssertionError: database connection isn't set to UTC" 오류를 해결하기 위한 방법입니다.

데이터베이스 연결 설정 변경

Django 설정 파일 (settings.py)에서 DATABASES 설정을 다음과 같이 변경하여 데이터베이스 연결을 UTC 시간대로 설정합니다.

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'my_database',
        'USER': 'postgres',
        'PASSWORD': 'my_password',
        'HOST': 'localhost',
        'PORT': '5432',
        'OPTIONS': {
            'timezone': 'UTC',
        },
    }
}

PostgreSQL 서버 설정 변경

PostgreSQL 서버의 시간대를 UTC로 설정합니다. PostgreSQL 설정 파일 (postgresql.conf)에서 timezone 설정을 다음과 같이 변경합니다.

timezone = 'UTC'

코드 변경

만약 코드에서 직접 날짜 및 시간 값을 설정하는 경우, UTC 시간대를 사용하여 설정해야 합니다. 예를 들어, 다음과 같이 datetime.datetime.utcnow() 함수를 사용하여 현재 시간을 UTC 시간대로 설정할 수 있습니다.

from django.utils import timezone

now = timezone.now()

'USE_TZ' 설정 활성화

Django 설정 파일 (settings.py)에서 USE_TZ 설정을 True로 설정하여 Django ORM이 모든 날짜 및 시간 필드를 UTC 시간대로 처리하도록 지정할 수 있습니다.

USE_TZ = True

주의 사항

데이터베이스 연결 설정 또는 PostgreSQL 서버 설정을 변경하기 전에 백업을 수행하는 것이 좋습니다.
'USE_TZ' 설정을 활성화하면 기존 데이터의 시간대 정보가 변경될 수 있습니다.

예제 코드

settings.py

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'my_database',
        'USER': 'postgres',
        'PASSWORD': 'my_password',
        'HOST': 'localhost',
        'PORT': '5432',
        'OPTIONS': {
            'timezone': 'UTC',
        },
    }
}

USE_TZ = True

models.py

from django.db import models

class MyModel(models.Model):
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

views.py

from django.utils import timezone

def my_view(request):
    # 현재 시간을 UTC 시간대로 설정
    now = timezone.now()

    # MyModel 인스턴스 생성
    model = MyModel(created_at=now, updated_at=now)
    model.save()

참고:

위 코드는 예시이며, 실제 프로젝트에서는 코드를 수정하여 사용해야 합니다.
코드를 수정하기 전에 Django와 PostgreSQL 문서를 참고하여 설정을 올바르게 변경해야 합니다.

"AssertionError: database connection isn't set to UTC" 오류 해결을 위한 대체 방법

USE_TZ = False

'USE_TZ' 설정을 비활성화하면 코드에서 직접 날짜 및 시간 값을 설정할 때 UTC 시간대를 사용해야 합니다.

'psycopg2' 버전 제한

Django 2.2와 psycopg2 2.9 이상 버전을 함께 사용하면 "AssertionError: database connection isn't set to UTC" 오류가 발생할 수 있습니다. 이 경우, psycopg2 버전을 2.8 이하로 제한하면 오류를 해결할 수 있습니다.

방법:

requirements.txt 파일에 다음과 같이 psycopg2 버전을 명시적으로 제한합니다.

psycopg2>=2.8,<2.9

psycopg2 버전을 제한하면 최신 버전의 기능을 사용할 수 없게 됩니다.

'django-timezone-fix' 패키지 사용

'django-timezone-fix' 패키지를 사용하여 Django ORM과 PostgreSQL의 시간대 문제를 해결할 수 있습니다.

프로젝트에 'django-timezone-fix' 패키지를 설치합니다.

pip install django-timezone-fix

Django 설정 파일 (settings.py)에 'django-timezone-fix' 패키지를 추가합니다.

INSTALLED_APPS = [
    # ...
    'django_timezone_fix',
]

'django-timezone-fix' 패키지는 Django 1.11 이상 버전에서만 사용할 수 있습니다.

'pytz' 패키지 사용

'pytz' 패키지를 사용하여 코드에서 직접 시간대를 변환할 수 있습니다.

코드에서 다음과 같이 'pytz' 패키지를 사용하여 UTC 시간대를 한국 시간대로 변환합니다.

from pytz import timezone

korean_timezone = timezone('Asia/Seoul')

# 현재 시간을 한국 시간대로 변환
now = korean_timezone.localize(datetime.datetime.now())

'pytz' 패키지는 다양한 시간대 정보를 제공합니다.

PostgreSQL 'ALTER DATABASE' 명령 사용

PostgreSQL 'ALTER DATABASE' 명령을 사용하여 데이터베이스의 시간대를 UTC로 변경할 수 있습니다.

psql -d my_database -c "ALTER DATABASE SET timezone TO 'UTC';"

'ALTER DATABASE' 명령을 사용하기 전에 데이터베이스를 백업하는 것이 좋습니다.

PostgreSQL 'ecpg' 함수 사용

PostgreSQL 'ecpg' 함수를 사용하여 코드에서 직접 시간대를 변환할 수 있습니다.

CREATE FUNCTION get_korean_time() RETURNS timestamp
AS
$$
SELECT CURRENT_TIMESTAMP AT TIME ZONE 'Asia/Seoul';
$$
LANGUAGE 'plpgsql';

# 현재 시간을 한국 시간대로 변환
SELECT get_korean_time();