파이썬과 Flask로 만드는 게시판 CRUD 완벽 가이드 💻🛠️

게시글을 웹에서 직접 작성하고 수정하고 삭제까지?
Flask와 SQLAlchemy만 있으면 가능합니다!
이 글 하나면 게시판 CRUD 구현은 완전 정복할 수 있어요.

안녕하세요, 여러분 😊

오늘은 Flask 웹 애플리케이션에서 가장 많이 사용되는 기능 중 하나인 CRUD(Create, Read, Update, Delete)를 직접 구현해볼 거예요.

단순히 이론 설명에서 그치는 게 아니라, 실제 웹 브라우저에서 게시글을 작성하고 목록을 보고, 수정하거나 삭제하는 완전한 게시판 시스템을 만들 거예요.

이 과정을 통해 Flask와 ORM(SQLAlchemy)의 활용 방법을 보다 실제적인 방식으로 배워보게 될 거예요.

기초부터 차근차근, 코드 한 줄 한 줄 이해하며 따라올 수 있게 구성했으니, 초보자도 걱정 말고 끝까지 함께 해봐요! 😉

1. 게시글 작성 기능 구현 (Create 기능) 📝

웹 게시판에서 가장 먼저 구현할 기능은 게시글 작성입니다.

사용자가 직접 제목과 내용을 입력하고 저장 버튼을 누르면, 해당 내용이 데이터베이스에 저장되고 목록이나 상세 페이지로 이동하게 만들 거예요.

우선 기본적인 흐름을 코드와 함께 살펴볼게요.

① 글 작성 폼 구현

`/board/new` 경로로 GET 요청 시 사용자에게 제목과 내용 입력란을 보여주는 HTML 폼을 렌더링합니다.

아래는 템플릿 예시입니다:

<form method="POST">
  <label>제목</label><br>
  <input type="text" name="title"><br>
  <label>내용</label><br>
  <textarea name="content"></textarea><br>
  <button type="submit">작성하기</button>
</form>

CSRF 방지와 보안은 이후 단계에서 `Flask-WTF` 같은 라이브러리를 통해 보완할 예정입니다.

지금은 기본적인 기능 흐름을 먼저 구현해보는 데 집중할게요!

② POST 요청 처리 및 DB 저장

사용자가 작성한 제목과 내용을 받아 `Post` 모델을 통해 DB에 저장합니다.

아래는 Flask 라우트 코드 예시예요:

@app.route('/board/new', methods=['GET', 'POST'])
def create_post():
    if request.method == 'POST':
        title = request.form['title']
        content = request.form['content']

        if not title or not content:
            flash('제목과 내용을 모두 입력해주세요.')
            return redirect(url_for('create_post'))

        post = Post(title=title, content=content)
        db.session.add(post)
        db.session.commit()

        flash('게시글이 작성되었습니다.')
        return redirect(url_for('post_detail', post_id=post.id))

    return render_template('create_post.html')

③ 피드백과 리다이렉트

작성 후에는 목록 페이지 또는 상세 페이지로 이동하며 flash를 통해 사용자에게 피드백 메시지를 전달할 수 있습니다.

템플릿에서 아래와 같이 메시지를 출력할 수 있어요:

{% with messages = get_flashed_messages() %}
  {% if messages %}
    <ul>
    {% for message in messages %}
      <li>{{ message }}</li>
    {% endfor %}
    </ul>
  {% endif %}
{% endwith %}

🧪 실습 포인트

• 제목 또는 내용을 비워서 제출했을 때 적절히 에러 처리가 되는지 확인해보세요.
• 글 작성 후 DB에 제대로 저장되었는지 SQLAlchemy로 직접 쿼리하거나 목록 페이지에서 확인해보세요.
• 작성 후 이동된 페이지에서 flash 메시지가 출력되는지 확인해보세요.

여기까지 구현하면 웹을 통해 실제로 글을 작성하고, 그것이 DB에 저장되는 전체 흐름을 직접 체험해볼 수 있어요.

다음은 작성된 글들을 조회해보는 기능, 목록 페이지로 넘어가볼게요!

2. 게시글 목록 조회 페이지 구현 (Read - 목록) 📋

게시판의 중심이 되는 페이지는 바로 목록 페이지입니다.

작성된 게시글들을 사용자에게 보여주는 역할을 하며, 각 게시글의 제목을 클릭하면 상세 페이지로 이동할 수 있어야 해요.

오늘은 이 목록 페이지를 Flask와 SQLAlchemy로 어떻게 구성할 수 있는지 하나씩 살펴보겠습니다.

① 목록 라우트 구현

/board 경로에서 모든 게시글을 조회할 수 있도록 라우트를 구현합니다.

작성일자를 기준으로 내림차순 정렬해 가장 최신 글이 위로 오도록 할 거예요.

@app.route('/board')
def post_list():
    posts = Post.query.order_by(Post.created_at.desc()).all()
    return render_template('post_list.html', posts=posts)

② 템플릿에서 게시글 목록 출력

게시글 데이터를 HTML에서 반복문을 통해 출력합니다.

게시글 제목을 클릭하면 상세 페이지로 이동하도록 링크를 걸어주세요.

<h2>게시글 목록</h2>
<ul>
  {% for post in posts %}
    <li>
      <a href="{{ url_for('post_detail', post_id=post.id) }}">{{ post.title }}</a>
      ({{ post.created_at.strftime('%Y-%m-%d %H:%M') }})
    </li>
  {% else %}
    <li>작성된 게시글이 없습니다.</li>
  {% endfor %}
</ul>

작성일이 보이도록 strftime을 활용해 날짜 포맷을 지정하는 것도 사용자 편의에 도움이 돼요.

③ (선택) 페이지네이션 기능 소개

글이 많아졌을 경우 모든 글을 한 페이지에 보여주는 것은 비효율적이에요.

이럴 땐 페이지네이션을 도입할 수 있습니다.

Flask-SQLAlchemy에서는 아래와 같이 페이지당 몇 개의 게시글을 보여줄지 설정할 수 있어요:

@app.route('/board')
def post_list():
    page = request.args.get('page', 1, type=int)
    posts = Post.query.order_by(Post.created_at.desc()).paginate(page=page, per_page=10)
    return render_template('post_list.html', posts=posts.items, pagination=posts)

실습에서는 구현하지 않아도 되지만, 프로젝트가 커질 경우 꼭 필요한 기능이에요.

Flask-Paginate 확장도 한 번 찾아보세요!

🧪 실습 포인트

• 게시글 여러 개를 작성한 뒤, 최신 순으로 잘 정렬되는지 확인해보세요.
• 게시글 제목을 클릭했을 때 해당 글의 상세 페이지로 잘 이동되는지 확인해보세요.
• 아무 글도 없을 때 ‘게시글이 없습니다’ 문구가 표시되는지도 테스트해보세요.

이제 목록 페이지도 완성되었네요!

다음은 하나의 게시글을 눌렀을 때 나오는 상세 보기와 수정 기능을 구현해볼 차례입니다. 💪

3. 게시글 상세 보기 및 수정 기능 구현 (Read/Update) ✏️

게시글 목록에서 사용자가 특정 게시글을 클릭했을 때, 그 게시글의 내용을 보여주는 상세 보기 페이지와, 이후 수정할 수 있는 기능까지 구현해볼 거예요.

이 단계에서는 동적 라우팅, 데이터 조회, 그리고 POST 기반 수정 처리를 중심으로 배워보겠습니다.

① 게시글 상세 보기 페이지 구현

사용자가 게시글 제목을 클릭하면 /board/<post_id> 경로로 이동하도록 구현합니다.

이때 post_id를 기준으로 해당 게시글을 데이터베이스에서 조회해 보여줍니다.

@app.route('/board/<int:post_id>')
def post_detail(post_id):
    post = Post.query.get_or_404(post_id)
    return render_template('post_detail.html', post=post)

get_or_404()는 ID에 해당하는 데이터가 없을 경우 자동으로 404 에러를 반환해주기 때문에 안전한 처리 방식입니다.

② 수정 폼 페이지 구현

게시글 상세 페이지에서 ‘수정’ 버튼을 누르면 /board/<post_id>/edit 경로로 이동합니다.

이 경로에서는 기존 게시글 데이터를 폼의 초기값으로 미리 넣어 보여줍니다.

@app.route('/board/<int:post_id>/edit', methods=['GET', 'POST'])
def edit_post(post_id):
    post = Post.query.get_or_404(post_id)
    if request.method == 'POST':
        post.title = request.form['title']
        post.content = request.form['content']

        if not post.title or not post.content:
            flash('빈 칸 없이 입력해주세요.')
            return redirect(url_for('edit_post', post_id=post.id))

        db.session.commit()
        flash('게시글이 수정되었습니다.')
        return redirect(url_for('post_detail', post_id=post.id))

    return render_template('edit_post.html', post=post)

POST 요청 시 사용자가 입력한 값으로 기존 객체의 속성을 업데이트하고, db.session.commit()으로 저장합니다.

③ 수정 폼 템플릿 예시

<form method="POST">
  <label>제목</label><br>
  <input type="text" name="title" value="{{ post.title }}"><br>
  <label>내용</label><br>
  <textarea name="content">{{ post.content }}</textarea><br>
  <button type="submit">수정하기</button>
</form>

🧪 실습 포인트

• 존재하지 않는 게시글 ID로 상세 페이지나 수정 페이지에 접근했을 때 404 오류가 잘 출력되는지 확인해보세요.
• 수정 후 변경 사항이 목록 페이지나 상세 페이지에 즉시 반영되는지 확인해보세요.
• 빈 입력값에 대한 처리와 사용자 피드백 메시지가 적절히 작동하는지 체크해보세요.

게시글 수정까지 완료했으니, 이제 남은 마지막 핵심 기능은 삭제입니다!

다음 단계에서는 게시글 삭제 처리 및 후속 처리까지 깔끔하게 구현해볼게요.

4. 게시글 삭제 기능 구현 (Delete) 🗑️

이제 게시글을 삭제하는 기능을 구현해볼 차례예요.

사용자 인터페이스에서 삭제 버튼을 클릭하면 해당 게시글이 실제로 데이터베이스에서 제거되고, 목록 페이지로 되돌아가게 만들 거예요.

삭제 전 확인 메시지를 띄우는 방법도 함께 알아봅시다.

① 삭제 버튼 추가하기

게시글 상세 페이지나 수정 페이지에서 삭제 버튼을 추가해 사용자가 클릭할 수 있도록 합니다.

아래는 HTML 폼을 사용한 간단한 예시예요:

<form method="POST" action="{{ url_for('delete_post', post_id=post.id) }}" 
      onsubmit="return confirm('정말 삭제하시겠습니까?');">
  <button type="submit">삭제하기</button>
</form>

자바스크립트의 confirm() 함수로 간단한 삭제 확인창도 띄워줍니다.

이렇게 하면 실수로 삭제하는 것을 방지할 수 있어요.

② Flask 라우트에서 삭제 처리

삭제 처리는 POST 방식으로 요청을 받아 처리하는 것이 일반적입니다.

아래는 Flask에서 삭제를 처리하는 라우트 예시입니다.

@app.route('/board/<int:post_id>/delete', methods=['POST'])
def delete_post(post_id):
    post = Post.query.get_or_404(post_id)
    db.session.delete(post)
    db.session.commit()
    flash('게시글이 삭제되었습니다.')
    return redirect(url_for('post_list'))

get_or_404()를 통해 유효하지 않은 접근은 방지하고, 삭제 후에는 목록 페이지로 리다이렉트하며 플래시 메시지로 피드백을 줍니다.

③ 삭제 후 상태 확인

삭제가 완료되면 목록 페이지에서 해당 글이 사라져야 하고,

삭제된 게시글의 상세 주소로 접근할 경우 404 오류가 발생해야 해요.

이를 통해 삭제가 확실히 이루어졌는지 확인할 수 있습니다.

🧪 실습 포인트

• 게시글 삭제 시 confirm 창이 잘 뜨는지 확인해보세요.
• 삭제 후 목록 페이지에서 해당 글이 사라지는지 확인해보세요.
• 삭제된 게시글 URL에 다시 접근했을 때 404 페이지가 나오는지도 꼭 확인해보세요.

이제 CRUD의 마지막 조각까지 완성되었습니다!

다음 단계에서는 전체 흐름을 다시 정리하고, CRUD를 어떻게 확장할 수 있을지에 대한 인사이트도 함께 나눠볼게요. 😊

5. CRUD 전체 사이클 정리 및 테스트 💡

지금까지 우리는 Flask와 SQLAlchemy를 활용해 게시판 CRUD 기능을 하나하나 구현해봤어요.

작성(Create), 조회(Read), 수정(Update), 삭제(Delete)까지 모든 사이클을 직접 경험하면서 웹 애플리케이션의 기본기를 탄탄하게 익혔습니다.

이 섹션에서는 전체 흐름을 다시 정리해보고, 실습 시 꼭 확인해야 할 테스트 항목들도 체크해볼게요.

① CRUD 사이클 요약 정리

② 전체 기능 테스트 체크리스트 ✅

• 글 작성 시 제목과 내용이 비어 있으면 경고 메시지가 표시되는가?
• 목록에서 최신 글이 가장 위에 오는가?
• 상세 페이지에서 제목, 내용, 작성 시간이 제대로 보이는가?
• 수정 시 기존 내용이 폼에 미리 채워지고, 수정 후 정상 반영되는가?
• 삭제 후 목록에서 글이 사라지고, 삭제된 글 URL 접근 시 404가 나오는가?

③ 다음 단계 미리 보기 👀

CRUD 기능은 웹 애플리케이션의 핵심 기초라고 할 수 있어요.

이후에는 이 기능들을 REST API 형태로 제공하거나, JavaScript를 활용해 비동기로 처리하는 등 다양한 확장으로 이어질 수 있어요. 예를 들어:

• 게시판을 API 형태로 만들어 React, Vue 같은 프론트엔드 프레임워크와 연동하기
• JWT 로그인 기능과 결합해 작성자 인증/권한 부여 기능 추가하기
• 댓글 기능, 파일 첨부 기능 등 게시판 고도화

이번 CRUD 구현이 단순한 끝이 아니라, 앞으로 나아갈 가능성의 출발점이라는 걸 꼭 기억해 주세요!

6. 마무리 및 다음 단계 안내 🚀

여기까지 따라오신 여러분 정말 수고 많으셨습니다! 👏

Flask와 SQLAlchemy를 사용한 게시판 CRUD 기능 구현을 하나하나 직접 해보며, 웹 애플리케이션 개발의 핵심 흐름을 완전히 익히셨을 거예요.

처음에는 생소했던 라우팅, 폼 데이터 처리, 데이터베이스 모델, 커밋과 쿼리 등 다양한 개념이 이제는 자연스럽게 느껴지실 겁니다.

이 CRUD 구현 경험은 이후의 모든 웹 개발 여정에 있어서 든든한 뼈대가 되어줄 거예요.

이번 실습을 통해 익힌 기술은 단순한 기능 구현을 넘어서, 실제 서비스를 만들고 유지보수하는 데에도 큰 도움이 됩니다.

그리고 여기서 끝이 아니에요!

다음 단계에서는 이 CRUD 기능들을 RESTful API로 전환하고, 프론트엔드와 연결하거나, 인증 기능을 넣는 방법도 배울 수 있어요.

웹 개발자로서 한 단계 더 도약할 수 있는 기반이 다져진 거죠. 😎

꼭 한 번 CRUD 기능을 자신만의 프로젝트에 적용해보세요.

예를 들어,

• 나만의 블로그 만들기
• 간단한 TODO 앱이나 일기장 만들기
• Flask와 React를 연동한 게시판 프로젝트 도전하기

앞으로도 꾸준히 연습하고 발전해 나가면, 어떤 웹 서비스도 직접 만들 수 있게 될 거예요.

우리는 이제 시작입니다! 😄

파이썬 ORM과 데이터베이스 연동 (SQLAlchemy)

데이터를 손쉽게 저장하고 꺼낼 수 있다면 얼마나 편할까요?
SQL 없이 파이썬 객체만으로 DB를 다룰 수 있는 방법,
지금 바로 알아보세요!

안녕하세요, 여러분!

Flask 웹 개발의 핵심 기능 중 하나는 바로 데이터베이스 연동이죠.

특히 게시판, 블로그, 사용자 시스템 등에서 데이터를 저장하고 불러오는 기능은 필수입니다.

오늘은 ORM(Object Relational Mapping) 개념부터 Flask-SQLAlchemy를 활용한 실제 데이터베이스 연동까지, 실습 중심으로 하나씩 차근차근 배워볼 거예요.

SQLite를 사용해 복잡한 환경 설정 없이 시작하고, 직접 모델을 정의하고 테이블을 생성해보며 ORM의 편리함을 체감해보세요.

실습 예제를 따라하면서 여러분만의 데이터 저장 시스템을 만들어봅시다!

1. ORM과 SQLAlchemy란? 🧠

여러분은 SQL 문을 일일이 작성하며 데이터를 관리하던 경험, 있으신가요?

테이블 생성, 삽입, 조회, 수정, 삭제… 이 모든 작업을 SQL 없이 파이썬 객체만으로 할 수 있다면 얼마나 편할까요?

바로 그걸 가능하게 해주는 기술이 ORM (Object Relational Mapping)입니다.

ORM이란 무엇인가요?

ORM은 객체 지향 프로그래밍(OOP)과 관계형 데이터베이스(RDB)를 연결해주는 브릿지 역할을 합니다.

즉, 테이블 → 클래스, 레코드 → 객체로 매핑해주는 거죠.

파이썬 클래스와 객체를 통해 데이터를 조작하고 관리할 수 있어, 마치 메모리 내 객체를 다루듯 DB 작업을 수행할 수 있습니다.

ORM은 단순히 편리함을 넘어서, 유지보수성과 재사용성, 보안성까지 함께 높여줍니다.

• SQL 문법을 몰라도 DB 조작이 가능해요
• DB 변경이 생겨도 코드 수정 최소화
• 보안상 SQL 인젝션 위험이 줄어듭니다

SQLAlchemy란?

SQLAlchemy는 파이썬에서 가장 널리 쓰이는 ORM 프레임워크입니다.

SQL을 완전히 추상화하여 객체 기반으로 DB 작업을 할 수 있게 도와주죠.

특히 다양한 DBMS(예: MySQL, PostgreSQL, SQLite, Oracle 등)를 지원하여 확장성 면에서도 매우 강력합니다.

Flask에서는 Flask-SQLAlchemy라는 확장 라이브러리를 통해 SQLAlchemy를 더 쉽고 간편하게 사용할 수 있어요.

SQLAlchemy의 핵심 특징

실습에서는 SQLite를 사용해볼 거예요.

설치가 필요 없고 파일 기반으로 바로 실행되니까 입문자에게 최적이거든요!

2. Flask-SQLAlchemy 설정 방법 ⚙️

ORM 개념과 SQLAlchemy에 대해 이해했다면, 이제 실전입니다!

Flask 애플리케이션에서 Flask-SQLAlchemy를 설정하고 SQLite와 연결해 보겠습니다.

1️⃣ Flask-SQLAlchemy 설치하기

pip install flask flask_sqlalchemy

Flask는 이미 설치되어 있다고 가정하고, flask_sqlalchemy만 설치하면 준비 완료입니다!

2️⃣ 데이터베이스 구성 설정

Flask 앱에서 SQLAlchemy를 사용하려면, 먼저 DB URI를 설정해야 합니다.

이번 실습에서는 SQLite를 사용하므로 다음과 같은 설정이 필요합니다:

# app.py 또는 config.py 파일 내
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///board.db'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

• sqlite:///board.db: 현재 프로젝트 폴더에 board.db 파일 생성
• SQLALCHEMY_TRACK_MODIFICATIONS: 변경 추적 기능 비활성화 (경고 방지)

3️⃣ SQLAlchemy 초기화

설정을 마쳤다면 Flask 애플리케이션에 SQLAlchemy를 초기화해야 합니다.

SQLAlchemy 객체를 생성한 후 Flask 앱과 연결하는 방식으로 진행합니다.

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///board.db'


# MySQL 연결 예시 (사용 시 주석 해제)
# app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://사용자이름:비밀번호@호스트주소:포트/데이터베이스이름'
# 예시: app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://root:password@localhost:3306/board_db'

# MariaDB 연결 예시 (사용 시 주석 해제)
# app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://사용자이름:비밀번호@호스트주소:포트/데이터베이스이름'
# 예시: app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://root:password@localhost:3306/board_db'


app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

db = SQLAlchemy(app)

MySQL이나 MariaDB를 Flask + SQLAlchemy로 연결할 때는 pymysql 또는 mysqlclient 같은 DB 드라이버가 필수입니다.

SQLAlchemy는 ORM이지만, 실제 DB와 통신은 Python용 DB 드라이버가 처리합니다. 즉,

• SQLAlchemy는 DB 쿼리를 객체화하고,
• pymysql 같은 드라이버가 실제 DB와 연결해주는 역할을 합니다.

✅ MySQL / MariaDB에서 가능한 드라이버

이렇게 하면 이후에 정의할 모델 클래스들이 자동으로 앱과 연결되어 DB와 상호작용하게 됩니다.

이제 준비가 끝났어요!

다음 단계에서는 실제로 게시글(Post) 모델을 정의하고 테이블과 매핑하는 과정을 배워볼게요.

3. 데이터 모델 정의와 테이블 매핑 📄

이제 본격적으로 ORM의 핵심 기능인 데이터 모델 정의에 들어갑니다.

여기서는 게시판의 핵심 데이터인 게시글을 관리하는 Post 모델을 만들고, 이 모델이 데이터베이스의 테이블과 어떻게 연결되는지를 알아볼 거예요.

📌 모델 클래스 만들기

SQLAlchemy에서는 DB 테이블을 Python 클래스 형태로 정의합니다.

모델 클래스는 db.Model을 상속하며, 클래스 변수로 각 필드를 정의합니다.

예를 들어 게시글(Post) 모델은 다음과 같이 만들 수 있어요:

from flask_sqlalchemy import SQLAlchemy
from datetime import datetime

db = SQLAlchemy()

class Post(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    title = db.Column(db.String(100), nullable=False)
    content = db.Column(db.Text, nullable=False)
    created_at = db.Column(db.DateTime, default=datetime.utcnow)

• id: 기본 키(PK), 자동 증가 정수
• title: 게시글 제목, 최대 100자, 필수 입력
• content: 본문 내용, 긴 텍스트 가능, 필수 입력
• created_at: 글 생성 시간, 자동으로 현재 시간 저장

🧩 선택: 사용자 모델과 관계 설정

시간 관계상 본 과정에서는 인증 기능을 구현하지 않지만, 관계형 DB에서는 모델 간 연결도 아주 중요합니다.

예를 들어 User와 Post 모델을 연결하면 다음과 같은 식으로 구성할 수 있어요.

class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80), unique=True, nullable=False)

class Post(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    title = db.Column(db.String(100), nullable=False)
    content = db.Column(db.Text, nullable=False)
    created_at = db.Column(db.DateTime, default=datetime.utcnow)
    user_id = db.Column(db.Integer, db.ForeignKey('user.id'))
    user = db.relationship('User', backref='posts')

ForeignKey와 relationship을 통해 일대다 관계를 명시할 수 있고,

이를 통해 ORM에서 연관 데이터를 자연스럽게 다룰 수 있어요.

이제 모델도 정의했으니, 다음 단계에서는 데이터베이스에 테이블을 실제로 생성하고 마이그레이션 도구를 통해 구조를 관리하는 방법을 배워볼게요.

4. 모델 간의 관계 설정하기 🔗

ORM의 진짜 강점은 복잡한 테이블 간 관계를 객체 지향적으로 관리할 수 있다는 점이에요.

특히 게시판처럼 게시글과 사용자, 댓글 등이 연결된 구조에서는 ForeignKey와 relationship 기능이 아주 유용합니다.

🔐 관계형 데이터베이스의 기본

관계형 데이터베이스에서는 여러 테이블 간에 관계를 설정해 데이터 중복을 줄이고, 데이터 무결성을 유지할 수 있습니다.

대표적인 관계는 다음과 같아요.

👥 User ↔ Post 관계 구현 예제

이번 예시에서는 한 명의 유저(User)가 여러 개의 게시글(Post)을 작성할 수 있는 일대다(1:N) 관계를 설정해봅니다.

class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80), unique=True, nullable=False)
    email = db.Column(db.String(120), unique=True, nullable=False)

class Post(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    title = db.Column(db.String(100), nullable=False)
    content = db.Column(db.Text, nullable=False)
    created_at = db.Column(db.DateTime, default=datetime.utcnow)
    user_id = db.Column(db.Integer, db.ForeignKey('user.id'))
    user = db.relationship('User', backref='posts')

• user_id: 외래 키(ForeignKey)로 User 테이블의 id와 연결
• relationship: Post 인스턴스에서 user 접근, User 인스턴스에서 posts 접근 가능

이제 한 유저가 작성한 모든 게시글을 user.posts로 가져올 수 있고, 게시글에서 작성자를 post.user로 확인할 수 있어요. 정말 직관적이지 않나요?

다음 단계에서는 이렇게 정의한 모델을 기반으로 실제 DB에 테이블을 생성하고 Flask-Migrate로 스키마 변경을 관리하는 방법을 알아보겠습니다.

5. 마이그레이션 도구로 테이블 관리하기 🔄

ORM을 사용해서 모델을 정의했으면, 그걸 기반으로 실제 데이터베이스 테이블을 만드는 작업이 필요합니다.

Flask에서는 db.create_all()을 통해 간단하게 테이블을 생성할 수 있어요.

하지만 실전 개발에서는 마이그레이션 도구를 사용하는 게 더 안전하고 유연합니다.

🛠 db.create_all()으로 초기 테이블 만들기

db.create_all()은 개발 초기 한 번만 사용하는 테이블 생성 함수입니다.

모델 정의가 끝난 후 다음 코드를 실행하면 해당 테이블이 SQLite에 생성됩니다.

from your_app_name import db

db.create_all()

하지만 테이블 구조가 바뀔 때마다 다시 DB를 지우고 만들 순 없잖아요? 그래서 Flask-Migrate를 사용하는 겁니다.

🧬 Flask-Migrate로 안전하게 관리하기

Flask-Migrate는 SQLAlchemy 기반 모델의 변경 사항을 추적하고,

DDL(SQL 명령어) 형태로 자동 변환해서 DB에 적용해주는 도구입니다.

Alembic이라는 강력한 마이그레이션 툴 위에 구축되어 있어요.

설치 및 설정

pip install flask-migrate

from flask_migrate import Migrate

migrate = Migrate(app, db)

이제 커맨드라인 명령을 통해 마이그레이션을 생성하고 적용할 수 있어요.

마이그레이션 명령어 모음

upgrade 명령이 완료되면 DB에 posts, users 등 테이블이 생성되어 있을 거예요.

직접 DB 파일을 열어보면 더욱 실감 나겠죠?

이제 테이블도 준비 완료!

다음은 이 모델과 테이블을 실제로 다뤄보는 실습 시간입니다.

데이터를 생성하고 저장하고, 다시 불러오는 전 과정을 직접 해볼 거예요.

6. 실습: 데이터 생성, 저장, 조회 🧪

드디어 지금까지 준비한 모델과 테이블을 바탕으로 실제 데이터를 생성하고 조회해볼 시간입니다.

이번 실습에서는 Flask Shell을 활용해 ORM의 기본 동작을 직접 체험해 볼 거예요.

📥 Flask Shell 실행하기

터미널에서 아래 명령어를 입력하면 Flask 앱의 컨텍스트에서 ORM 객체를 바로 사용할 수 있습니다.

flask shell

그 다음 아래처럼 게시글 데이터를 만들어보고 저장해볼 수 있어요.

>>> from app import db
>>> from models import Post
>>> post = Post(title="첫 번째 글", content="ORM으로 저장된 글입니다!")
>>> db.session.add(post)
>>> db.session.commit()

위 코드로 데이터베이스에 게시글 하나가 저장됩니다.

별도의 SQL 없이도 Python 객체를 통해 저장할 수 있는 게 ORM의 묘미죠!

🔍 저장된 게시글 조회하기

조회는 더 간단해요.

query 속성을 사용하면 모든 데이터를 불러오거나, 조건을 걸어 하나만 찾을 수도 있죠.

>>> Post.query.all()
>>> Post.query.filter_by(title="첫 번째 글").first()

• all(): 전체 데이터 리스트 조회
• filter_by(): 조건 검색 (WHERE 절)

📤 데이터를 삭제하거나 수정하려면?

삭제와 수정도 역시 객체 기반으로 처리할 수 있습니다.

SQL 없이도 데이터를 조작할 수 있으니 정말 직관적이에요.

>>> post = Post.query.get(1)
>>> post.title = "제목 수정됨"
>>> db.session.commit()

>>> db.session.delete(post)
>>> db.session.commit()

정말 쉽죠?

SQL이 필요 없는 이 간편함, ORM을 배우는 가장 큰 이유라고 해도 과언이 아닙니다.

이제 Flask와 ORM, 그리고 SQLite를 활용해서 기본적인 CRUD(생성, 조회, 수정, 삭제) 작업을 모두 수행할 수 있게 되었어요!

이걸 바탕으로 다음 시간에는 뷰 함수와 연결된 게시판 기능을 구현하게 될 거예요.

마무리 🎯

지금까지 Flask 애플리케이션에서 ORM을 사용해 데이터베이스와 연동하는 과정을 처음부터 끝까지 살펴봤습니다.

ORM의 개념 이해부터 SQLAlchemy 설치, 모델 정의, 관계 설정, 마이그레이션, 그리고 실전 테스트까지...

꽤 많은 걸 함께 해봤네요.

SQL을 몰라도 객체 지향적으로 DB를 다룰 수 있다는 점, 그리고 마치 파이썬 코드만으로 모든 데이터를 조작할 수 있다는 게 ORM의 가장 큰 장점이에요.

이제 여러분은 Flask에서 SQLite를 활용해 동적인 데이터를 저장하고, 불러오고, 수정하고, 삭제할 수 있는 기반을 갖췄어요.

다음 단계에서는 이 데이터들을 기반으로 사용자에게 보여주는 인터페이스,

즉 뷰 함수와 템플릿을 통해 웹페이지에서 게시글 목록과 내용을 직접 확인하고 조작하는 방법을 배울 거예요.

여기까지 오신 여러분, 정말 고생 많으셨어요.

직접 코드를 실행하고 테스트해보면서 익히면 훨씬 더 오래 기억에 남을 거예요. 그럼 다음 단계에서 다시 만나요!

Flask 애플리케이션 구조화 (Blueprint)와 에러 핸들링

복잡해지는 Flask 프로젝트,
하나의 파일로 관리하고 계신가요?
지금이 구조화를 배워야 할 때입니다!

안녕하세요, Flask 웹 개발 여정을 함께하고 있는 여러분 반갑습니다 😊

셋째 날에는 프로젝트 규모가 커질수록 꼭 필요한 애플리케이션 구조화와 에러 핸들링에 대해 배워볼 거예요.

처음엔 단순했던 app.py 하나로 잘 운영되던 앱도 기능이 늘어나면 유지보수가 어려워지기 마련이죠.

이럴 때 Blueprint를 활용하면 각 기능을 깔끔하게 나눌 수 있고,

@errorhandler와 abort() 등을 통해 사용자에게 더 친절한 오류 메시지를 보여줄 수 있습니다.

실습과 함께 프로젝트 구조를 정리해보면서 한층 더 실전 같은 웹 앱으로 성장시켜볼까요?

1. Blueprint 개념과 필요성 🧩

Flask로 웹 애플리케이션을 만들다 보면 처음에는 모든 라우터와 로직을 하나의 app.py 파일에 작성하게 되죠.

하지만 기능이 늘어나고 규모가 커질수록 이 파일은 점점 복잡해지고, 유지보수가 어려워지기 시작합니다.

바로 이럴 때 Blueprint가 등장합니다.

Blueprint란 무엇인가요?

Blueprint는 Flask에서 제공하는 모듈화 도구로, 애플리케이션의 기능을 분리된 파일과 폴더로 나누어 관리할 수 있게 해줍니다.

각각의 Blueprint는 독립적인 라우팅, 템플릿, 정적 파일 등을 가질 수 있어 하나의 작은 앱처럼 동작할 수 있죠.

그리고 최종적으로 메인 애플리케이션에 등록하여 전체 시스템의 일부분으로 동작하게 됩니다.

• 라우트 및 뷰 함수 분리로 코드 가독성 향상
• 협업 시 역할 분담 용이 (예: board, auth, admin 모듈)
• URL prefix로 기능별 주소 체계 구성

Blueprint 적용 전과 후의 구조 비교

Blueprint를 꼭 써야 할까?

처음부터 복잡하게 구조화하려는 강박은 없었으면 해요.

하지만 기능이 3개 이상이라면, 혹은 협업이 필요하거나 앱이 커질 계획이 있다면, Blueprint는 필수입니다.

그리고 이건 단순한 폴더 분할이 아닌 Flask 철학에 맞는 확장 가능한 설계이기도 해요.

자, 이제 기본 개념을 이해했으니...

다음은 실습을 통해 실제로 Blueprint를 생성하고 등록해보는 시간을 가져볼게요! 👇

2. Blueprint 생성 및 등록 실습 🛠️

Blueprint의 이론을 이해했다면 이제 직접 만들어볼 차례죠!

이 실습에서는 게시판 기능을 별도의 board.py 파일로 분리하고, 메인 앱에서는 이를 불러와서 등록하는 흐름을 구성해보겠습니다.

Blueprint 생성: board.py 파일 작성

우선 게시판 관련 기능을 담을 board.py 파일을 생성합니다.

이 안에는 Blueprint 객체를 만들고, 그 안에 라우트를 정의합니다.

from flask import Blueprint, render_template

board_bp = Blueprint('board', __name__, url_prefix='/board')

@board_bp.route('/')
def board_list():
    return render_template('board/list.html')

@board_bp.route('/')
def board_detail(post_id):
    return render_template('board/detail.html', post_id=post_id)

• Blueprint() 생성 시 url_prefix로 라우트 기본 경로를 지정합니다.
• 라우트 정의는 @board_bp.route 데코레이터를 사용합니다.

Blueprint 등록: app.py 수정

다음으로 board.py에 정의된 Blueprint를 메인 애플리케이션에 등록해보죠.

app.py를 다음과 같이 수정합니다:

from flask import Flask
from board import board_bp

app = Flask(__name__)
app.register_blueprint(board_bp)

@app.route('/')
def index():
    return '메인 페이지'

이제 /board로 시작하는 URL들은 모두 board.py에서 정의된 라우트로 연결됩니다.

템플릿 디렉토리 분리 및 테스트

템플릿 파일은 templates/board/ 폴더를 만들어 관리합니다.

예를 들어 게시글 목록을 보여주는 템플릿은 아래처럼 구성할 수 있겠죠.

<!-- templates/board/list.html -->
<h1>게시판 목록</h1>
<p>이곳은 게시판 메인입니다.</p>

이제 서버를 실행한 후 http://localhost:5000/board로 접속하면 게시판 라우트가 정상 작동하는지 확인해보세요!

✅ 실습 요약

• Blueprint는 from flask import Blueprint로 생성
• 라우트는 @board_bp.route로 작성
• 메인 앱에 register_blueprint()로 등록

다음 장에서는 이 구조를 바탕으로 실제 프로젝트를 리팩터링해보고,

더 정돈된 구조로 발전시켜 보겠습니다! 💪

3. 기존 프로젝트 구조 리팩터링 🗂️

지금까지는 간단한 예제 중심으로 Blueprint를 실습했죠.

이번에는 실제로 우리가 만든 Flask 애플리케이션을 기능별로 나누고, 디렉토리 구조를 재편해보는 시간을 가져보겠습니다.

프로젝트가 커지면 구조화가 얼마나 중요한지 직접 느껴보실 수 있을 거예요.

디렉토리 구조 개편 예시

myflaskapp/
│
├── app.py                  # Flask 앱 생성 및 Blueprint 등록
├── board/
│   ├── __init__.py         # Blueprint 객체 생성
│   ├── views.py            # 게시판 라우팅 로직
│   └── templates/
│       └── board/
│           ├── list.html   # 게시글 목록 템플릿
│           └── detail.html # 게시글 상세 템플릿
├── static/
│   └── css/
│       └── style.css       # 공통 스타일 시트
└── templates/
    └── base.html           # 공통 레이아웃 템플릿

이처럼 각 기능은 독립된 폴더(board/)로 나뉘고, __init__.py에서 Blueprint를 초기화한 뒤, views.py로 라우트를 따로 관리합니다.

템플릿도 해당 Blueprint 하위에 위치시켜 명확한 소속을 표현하죠.

🔧 예제 코드: board/__init__.py

from flask import Blueprint

board_bp = Blueprint('board', __name__, url_prefix='/board')

from . import views

🧩 예제 코드: board/views.py

from flask import render_template
from . import board_bp

@board_bp.route('/')
def list_posts():
    return render_template('board/list.html')

@board_bp.route('/<int:post_id>')
def post_detail(post_id):
    return render_template('board/detail.html', post_id=post_id)

템플릿 디렉토리 또한 templates/board/에 위치시키면 Flask가 자동으로 해당 위치를 찾아 렌더링합니다.

특히 팀 프로젝트에서 이런 구조는 유지보수성과 협업 효율을 대폭 향상시켜줍니다.

💡 리팩터링 실습 팁

• URL은 /board, /board/1 등이 예상 경로입니다.
• 라우트 이름은 가급적 의미 있는 이름으로! list_posts(), post_detail()처럼요.
• 앱 실행 전 __init__.py에 from . import views 빠뜨리지 않도록 주의!

여기까지 리팩터링을 잘 마쳤다면 이제 프로젝트 구조가 훨씬 명확하고 확장 가능한 상태가 되었을 거예요.

다음은 이 구조 위에 에러 핸들링을 추가해서 사용자 경험을 한 단계 더 끌어올려보겠습니다!

4. Flask 에러 핸들링 기법 ⚠️

웹 서비스를 운영하다 보면 오류 상황은 피할 수 없어요.

하지만 오류를 어떻게 처리하느냐에 따라 사용자 경험이 완전히 달라질 수 있습니다.

Flask는 @errorhandler 데코레이터와 abort() 함수를 통해 예외 상황을 보다 우아하게 처리할 수 있도록 도와줍니다.

기본 에러 핸들링: @app.errorhandler

다음은 대표적인 에러인 404 Not Found 오류를 처리하는 코드예요.

@app.errorhandler(404)
def page_not_found(error):
    return render_template('errors/404.html'), 404

• 404 외에도 403, 500 등의 에러 코드도 커스텀 핸들링 가능해요.
• HTML 템플릿 파일은 templates/errors/에 분리 저장하는 걸 추천합니다.

abort() 함수로 명시적 에러 발생

Flask에서는 조건에 따라 특정 HTTP 에러를 명시적으로 발생시킬 수도 있어요.

예를 들어 잘못된 게시글 ID가 들어오면 이렇게 처리할 수 있습니다.

from flask import abort

@board_bp.route('/<int:post_id>')
def post_detail(post_id):
    post = get_post_or_none(post_id)
    if post is None:
        abort(404)
    return render_template('board/detail.html', post=post)

이렇게 abort()를 호출하면 Flask가 자동으로 해당 에러 코드에 맞는 핸들러를 호출해줍니다.

Blueprint별 에러 처리도 가능!

재미있는 건, 각 Blueprint에 독립적인 에러 핸들러를 정의할 수 있다는 거예요.

@board_bp.errorhandler(404)
def board_404(error):
    return render_template('board/404.html'), 404

이렇게 하면 게시판 페이지에서 발생한 404는 전용 템플릿으로 분기되고, 나머지 앱 전체에 대해선 @app.errorhandler가 적용되죠.

유저 입장에선 더 세심한 UI로 느껴질 수 있어요.

에러 로깅은 어떻게 하나요?

개발 모드에서는 Flask가 자동으로 오류 스택 트레이스를 보여주죠.

하지만 운영 환경에서는 app.logger를 사용해서 중요한 오류를 로그 파일에 기록하는 것이 좋습니다.

import logging

@app.errorhandler(500)
def internal_error(error):
    app.logger.error(f'Server Error: {error}')
    return render_template('errors/500.html'), 500

이 방식은 운영 서버에서 발생하는 심각한 오류를 추적하고 개선하는 데 매우 유용해요.

✅ 핵심 요약

• @app.errorhandler 또는 @blueprint.errorhandler로 커스텀 오류 처리
• abort()로 조건부 오류 강제 발생 가능
• app.logger를 통해 서버 오류 기록

다음은 요청 전후의 공통 작업을 자동화하는 방법인 요청 훅과 미들웨어 유사 기능에 대해 알아보겠습니다.

서버가 모든 요청을 어떻게 처리하는지 흐름을 이해하면, 더 강력한 기능도 구현할 수 있어요!

5. 요청 훅과 미들웨어 유사 기능 🔄

Flask에는 Django처럼 미들웨어 체인이 명시적으로 존재하지는 않지만, 그 대신 요청 훅(hook)을 이용해 유사한 기능을 구현할 수 있어요.

전역적으로 실행되는 전처리/후처리 로직을 통해 인증 검사, 로깅, CORS 헤더 추가 등 다양한 동작을 자동화할 수 있습니다.

@app.before_request / @app.after_request

모든 요청에 대해 실행되는 전처리와 후처리 훅은 다음처럼 정의할 수 있어요:

from flask import request

@app.before_request
def log_request_info():
    print(f"[요청] {request.method} {request.path}")

@app.after_request
def add_header(response):
    response.headers['X-Frame-Options'] = 'DENY'
    return response

• before_request: DB 연결, 사용자 인증 등 선처리에 유용
• after_request: 응답 헤더 추가, 캐시 처리 등에 사용

Blueprint에서 요청 훅 쓰기

요청 훅은 app뿐 아니라 Blueprint에서도 사용할 수 있어요.

예를 들어 게시판 라우트에만 접근 권한을 체크하고 싶을 땐 아래처럼 작성합니다.

@board_bp.before_request
def check_board_auth():
    if not user_has_board_permission():
        return "접근이 제한된 페이지입니다.", 403

이렇게 하면 /board로 시작하는 URL에 대해서만 인증 로직이 동작해요.

전체 앱과 독립적으로 작동하니 구조 관리에 매우 유리하죠.

WSGI 미들웨어 소개 (간략)

보다 정교한 미들웨어 처리가 필요하다면 Flask의 하위 레벨인 WSGI 미들웨어를 사용할 수도 있어요.

다만 이는 Flask 자체보다는 웹 서버와의 연동 관점에서 다뤄지며, 대부분의 경우 요청 훅으로 충분합니다.

✅ 요약 정리

• before_request는 인증, 로깅 등 요청 전 공통 처리에 적합
• after_request는 응답 헤더 수정, 후처리에 사용
• Blueprint마다 훅 설정 가능 → 인증, 필터 등 기능별 적용

이제 Flask 앱이 점점 더 체계적인 구조와 기능을 갖추게 되었어요.

마지막으로, 이런 기능들을 더욱 풍부하게 만들어주는 Flask 확장들을 소개하면서 이번 단원을 마무리해볼게요.

6. Flask 확장 라이브러리 소개 📦

Flask는 마이크로 프레임워크인 만큼, 기본 기능이 최소화되어 있어요.

대신에 필요한 기능을 선택적으로 확장할 수 있는 수많은 라이브러리가 존재합니다.

이번에는 Flask 개발에서 자주 사용되는 확장 도구들을 간단히 정리해볼게요.

1. Flask-SQLAlchemy - ORM 기능 🧮

SQLAlchemy는 강력한 ORM(Object-Relational Mapping) 라이브러리입니다.

Flask-SQLAlchemy는 이를 Flask에 쉽게 통합할 수 있도록 도와주는 확장이죠.

• ORM을 통해 SQL 없이도 DB 조작 가능
• 다양한 DB 지원 (MySQL, PostgreSQL, SQLite 등)

2. Flask-Migrate - DB 마이그레이션 도구 🔄

Flask-Migrate는 데이터베이스 스키마 변경을 관리하는 도구예요.

프로젝트 중반에 테이블 구조가 바뀔 때도 명령어 한 줄로 변경 사항을 적용할 수 있어 매우 유용합니다.

flask db init
flask db migrate -m "Add users table"
flask db upgrade

3. Flask-WTF - 폼 처리 및 검증 📄✅

웹 폼은 사용자 입력의 핵심이죠.

Flask-WTF는 Flask에서 폼 클래스 기반 입력 처리를 가능하게 해주는 확장입니다.

CSRF 보호와 유효성 검사도 기본으로 제공해요.

• HTML 폼 → Python 클래스 기반 처리
• 입력 검증 및 에러 메시지 처리 자동화

4. Flask-Login - 사용자 인증 🔐

회원 가입, 로그인, 로그아웃 기능을 구현하려면 Flask-Login이 제격입니다.

인증 흐름을 매우 간단하게 만들어주는 유용한 도구죠.

from flask_login import LoginManager

login_manager = LoginManager()
login_manager.init_app(app)

✅ 이 외에도 인기 있는 Flask 확장

• Flask-Caching – 캐시 처리로 성능 향상
• Flask-Mail – 이메일 전송 기능
• Flask-RESTful – REST API 개발을 위한 구조화 도구

우리가 앞으로 이 커리큘럼에서 활용할 주요 확장은 Flask-SQLAlchemy, Flask-Migrate, Flask-WTF예요. 인증이 필요한 기능에서는 Flask-Login도 함께 써볼 거고요.

필요에 따라 다른 확장도 자유롭게 추가할 수 있어요.

이제 Flask의 구조화와 오류 처리, 요청 훅, 확장까지 모두 익혔다면, 복잡한 웹 애플리케이션도 자신감 있게 개발할 수 있어요!

다음 수업에서는 ORM과 데이터베이스를 본격적으로 다뤄볼 예정이니 기대해주세요 😊

지금까지 Flask 애플리케이션을 구조화하는 방법부터 에러를 다루는 방법, 공통 동작을 처리하는 요청 훅, 그리고 개발을 도와주는 확장 도구까지 차근차근 살펴봤습니다.

처음엔 조금 복잡해 보일 수 있지만, 실제로 코드를 나누고 정리하다 보면 더 깔끔하고 안정적인 서비스 구조를 만들 수 있어요.

특히 Blueprint를 활용한 모듈화는 프로젝트가 커졌을 때 그 진가를 발휘합니다.

더불어, @app.errorhandler, abort(), before_request 같은 기능은 개발자의 세심함을 사용자에게 전달할 수 있는 강력한 도구죠.

앞으로 더 복잡한 기능을 구현하기 위해선 이런 기초를 튼튼히 다지는 게 중요하답니다 💪

다음 강의에서는 ORM을 활용한 데이터베이스 연동을 본격적으로 다루게 될 텐데요,

오늘 배운 구조화 개념이 이후 내용과도 깊게 연결되니 꼭 복습해두세요.

직접 실습을 통해 익히는 것이 최고의 학습 방법이라는 것, 잊지 마세요!