python gunicorn 가동 실패 이유 찾기

프로젝트 배포를 위해 gunicorn을 구동시킬 경우 알 수 없는 문구와 함께 시동조차 하지 못하고 죽어버리는 경우가 있다.

주로 아래 문구를 포함한 에러가 발생한다.

gunicorn.errors.HaltServer: <HaltServer 'Worker failed to boot.' 3>

gunicorn이 시작조차 못하고 죽기 때문에 로그가 남지 않기에 어디서 에러가 나는지 찾기 힘들다.

이럴땐 직접 gunicorn cli에서 제공하는 --preload 옵션을 사용하면 구체적인 원인을 찾을 수 있다.

virtualenv를 사용하는 경우 activate 명령어로 가상환경을 활성화 한 후에 명령어를 날려야 한다.

gunicorn --preload [project].wsgi:application

프로젝트명이 test 라면 test.wsgi를 바인딩해주면 된다.