파이썬 - Error: The file/path provided (...) does not appear to exist
flask 실행 시 이렇게 오류가 발생하면,
$ flask run
Usage: flask run [OPTIONS]
Try 'flask run --help' for help.
Error: Could not locate Flask application. You did not provide the FLASK_APP environment variable.
For more information see http://flask.pocoo.org/docs/latest/quickstart/
오류 메시지에 따라 FLASK_APP 환경 변수가 없어서 그런 것입니다. 그런데 설정을 해도,
$ export FLASK_APP=test
$ flask run
Usage: flask run [OPTIONS]
Try 'flask run --help' for help.
Error: Failed to find application in module "test". Are you sure it contains a Flask application? Maybe you wrapped it in a WSGI middleware or you are using a factory function.
저런 오류가 발생하는 것은 현재 위치를 기준으로 ./test 하위 디렉터리가 없기 때문입니다. (혹은, 어떤 식으로든 명시한 'test' 모듈을 찾을 수 없는 상황입니다.) 대체로, 제대로 된 flask app 이름을 설정하지 않은 경우인데요, 그런데, 해당 모듈을 찾을 수 있다고 해도 이렇게 오류가 발생할 수 있습니다.
$ export FLASK_APP=test
$ flask run
Usage: flask run [OPTIONS]
Try 'flask run --help' for help.
Error: The file/path provided (test) does not appear to exist. Please verify the path is correct. If app is not on PYTHONPATH, ensure the extension is .py
유사한 오류가 flask가 지원하는 명령을 내려도 동일하게 나옵니다.
$ flask db init
Usage: flask db init [OPTIONS]
Try 'flask db init --help' for help.
Error: The file/path provided (test) does not appear to exist. Please verify the path is correct. If app is not on PYTHONPATH, ensure the extension is .py
$ flask db upgrade
Usage: flask db upgrade [OPTIONS] [REVISION]
Try 'flask db upgrade --help' for help.
Error: The file/path provided (test) does not appear to exist. Please verify the path is correct. If app is not on PYTHONPATH, ensure the extension is .py
원인은 간단합니다. flask는 현재 디렉터리에서 FLASK_APP 환경 변수로 등록된 값의 py 파일을 찾기 때문입니다. 즉, 위와 같이 FLASK_APP=test인 상황이라면 test.py 파일이 현재 디렉터리에 있어야 합니다.
만약 flask app을 test라는 이름으로 생성했는데, 그것의 진입점을 "wsgi.py"라는 파일로 구성했다면,
$ cat wsgi.py
import test
application = test.create_app()
FLASK_APP 환경 변수를 wsgi로 설정해야 합니다.
$ export FLASK_APP=wsgi
$ flask run
name test
* Serving Flask app "wsgi"
* Running on http://127.0.0.1:5000 (Press CTRL+C to quit)
이런 문제는, flask 응용 프로그램이 환경 변수로만 진입점을 받아들이기 때문입니다. 가령 동일한 flask app을
uwsgi와 같은 응용 프로그램에서 호스팅한다면 (환경 변수 설정 없이) 다음과 같이 실행할 수 있습니다.
// FLASK_APP 환경 변수를 설정하지 않아도,
$ uwsgi --http-socket :18091 --wsgi-file ./wsgi.py
왜 flask는 uwsgi처럼 --wsgi-file과 같은 옵션을 제공하지 않는 걸까요? ^^
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]