Error: Failed to find Flask application or factory in module 'wsgi'.

2025. 4. 25. 04:40·기술블로그-Flask편
목차
  1. 🎯 1️⃣ FLASK_APP을 run.py로 설정
  2. 2️⃣ 그리고 바로 실행
  3. 📂 wsgi.py

wsgi 파일 안에 Flask 앱이 제대로 지정되지 않았거나,
환경변수가 설정되지 않아서 발생한 문제입니다.

🚨 wsgi.py가 무엇인가요?

  • wsgi.py = Flask 앱을 외부 서버(gunicorn, uWSGI 등)와 연결해주는 역할
  • 개발용 서버(python run.py)에서는 사용하지 않아요.
  • 배포 시 서버가 Flask 앱을 인식하게 하기 위한 표준 인터페이스입니다.

✅ 개발 단계에서는 이렇게 진행!

우리는 지금 Flask-Migrate로 DB 생성하려는 거니까,
wsgi.py는 신경 쓰지 말고, 그냥 run.py 기준으로 설정하면 돼요!


🎯 1️⃣ FLASK_APP을 run.py로 설정

export FLASK_APP=run.py

또는, 만약 run.py 안에 Flask 앱이 application 이름이라면:

export FLASK_APP=run.py:application

2️⃣ 그리고 바로 실행

flask db init
flask db migrate -m "Initial migration"
flask db upgrade

💡 만약 wsgi.py가 꼭 필요하다면?

혹시 형식상 wsgi.py가 필요하다면, 아래처럼 간단히 작성하세요!

📂 wsgi.py

from app import create_app

application = create_app()

이렇게만 해도 충분합니다! (배포용 기본 세팅)


🎯 정리

상황처리 방법
개발 환경 FLASK_APP=run.py 설정 후 진행
배포용 wsgi 필요 시 위 예시처럼 간단히 작성

'기술블로그-Flask편' 카테고리의 다른 글

Scripts 파일 ignore됬을때 대처법 (.gitignore)  (0) 2025.04.25
Flask Static 폴더를 활용한 이미지 관리 가이드  (0) 2025.04.25
MySQL TRUNCATE vs DELETE 차이점 정리  (0) 2025.04.25
🚀 Flask 프로젝트에서 ORM과 CRUD 구현하기 (SQLAlchemy 활용)1-3  (0) 2025.04.24
🚀 Flask 프로젝트에서 routes.py와 services의 역할 이해하기(1-2)  (0) 2025.04.24
  1. 🎯 1️⃣ FLASK_APP을 run.py로 설정
  2. 2️⃣ 그리고 바로 실행
  3. 📂 wsgi.py
'기술블로그-Flask편' 카테고리의 다른 글
  • Scripts 파일 ignore됬을때 대처법 (.gitignore)
  • Flask Static 폴더를 활용한 이미지 관리 가이드
  • MySQL TRUNCATE vs DELETE 차이점 정리
  • 🚀 Flask 프로젝트에서 ORM과 CRUD 구현하기 (SQLAlchemy 활용)1-3
Chansman
Chansman
안녕하세요! 코딩을 시작한 지 얼마 되지 않은 초보 개발자 찬스맨입니다. 이 블로그는 제 학습 기록을 남기고, 다양한 코딩 실습을 통해 성장하는 과정을 공유하려고 합니다. 초보자의 눈높이에 맞춘 실습과 팁, 그리고 개발하면서 겪은 어려움과 해결 과정을 솔직하게 풀어내려 합니다. 함께 성장하는 개발자 커뮤니티가 되기를 바랍니다.
  • Chansman
    찬스맨의 프로그래밍 스토리
    Chansman
  • 전체
    오늘
    어제
    • 분류 전체보기 (702)
      • Python (32)
      • 프로젝트 (43)
      • 과제 (25)
      • Database (40)
      • 멘토링 (11)
      • 특강 (37)
      • 기술블로그 (40)
      • 기술블로그-Fastapi편 (33)
      • 기술블로그-Django편 (153)
      • 기술블로그-Flask편 (36)
      • AI 분석 (4)
      • HTML & CSS (31)
      • JavaScript (17)
      • AWS_Cloud (21)
      • 웹스크래핑과 데이터 수집 (14)
      • Flask (42)
      • Django (77)
      • Fastapi (16)
  • 블로그 메뉴

    • 홈
    • 태그
    • 방명록
  • 링크

  • 공지사항

  • 인기 글

  • 태그

  • 최근 댓글

  • 최근 글

  • hELLO· Designed By정상우.v4.10.3
Chansman
Error: Failed to find Flask application or factory in module 'wsgi'.

개인정보

  • 티스토리 홈
  • 포럼
  • 로그인
상단으로

티스토리툴바

단축키

내 블로그

내 블로그 - 관리자 홈 전환
Q
Q
새 글 쓰기
W
W

블로그 게시글

글 수정 (권한 있는 경우)
E
E
댓글 영역으로 이동
C
C

모든 영역

이 페이지의 URL 복사
S
S
맨 위로 이동
T
T
티스토리 홈 이동
H
H
단축키 안내
Shift + /
⇧ + /

* 단축키는 한글/영문 대소문자로 이용 가능하며, 티스토리 기본 도메인에서만 동작합니다.