트러블 슈팅 개요

Django 프로젝트를 PostgreSQL과 연결하려고 할 때, 가상환경(venv)에서 PostgreSQL CLI 도구(psql)가 제대로 동작하지 않는 문제가 발생했습니다. 가상환경의 PATH 환경변수 설정과 관련된 문제였습니다.

문제

1. python manage.py dbshell 명령 실행 시

CommandError: You appear not to have the 'psql' program installed or on your path.

2. psql 명령 실행 시

bash: psql: command not found

3. PostgreSQL과 Django가 연결되지 않아 데이터베이스 테이블 확인 및 작업이 불가능

---

원인

echo $PATH명령어를 통해 가상환경의 환경변수 path를 확인하니 postgres 경로가 없어서 가상환경을 실행하면 찾질 못함!

가상환경이 기본 PATH를 덮어씀

Windows에서 가상환경(venv)을 활성화하면 기본 PATH가 덮어쓰여 PostgreSQL bin 디렉토리가 포함되지 않음.

해결

1. PostgreSQL bin 경로를 PATH에 추가

export PATH="$PATH:/c/Program Files/PostgreSQL/17/bin"
# 17은 postgres 버전입니다.

2. 설정 확인

echo $PATH

다시 migrate를 실행하고 DBeaver에서 연결된 Table을 확인하니 아래와 같이 정상적으로 연동된 것을 확인 할 수 있었다 ^^