Session mặc định của Flask lưu toàn bộ dữ liệu trong cookie — giỏ hàng càng nhiều món, cookie càng phình to, và ai cũng đọc được nội dung vì cookie chỉ được ký, không mã hóa. Flask-Session chuyển dữ liệu session lên server (Redis), trình duyệt chỉ giữ một session id ngắn. Bài này hướng dẫn cấu hình Flask-Session 0.8.0 với Redis trong 5 phút — code dùng session không đổi dòng nào.

Vấn đề: session mặc định nằm gọn trong cookie

Khi bạn gán session['cart'] = [...], Flask serialize dữ liệu thành JSON, ký bằng SECRET_KEY rồi đặt vào cookie session gửi kèm mọi request. Cách này tiện lúc đầu nhưng có ba hệ quả khó chịu. Thứ nhất, trình duyệt giới hạn mỗi cookie khoảng 4KB — giỏ hàng nhiều món là cookie vượt giới hạn, session “mất” bí ẩn. Thứ hai, dữ liệu chỉ được ký chứ không mã hóa: ai cũng giải mã base64 để đọc được giỏ hàng hay thông tin nhạy cảm lỡ lưu trong session. Thứ ba, mỗi request đều cõng theo toàn bộ session. Đo thực tế trên Flask 3.1.3: giỏ hàng 51 món khiến cookie dài 1.294 ký tự.

from flask import Flask, session
app = Flask(__name__)
app.config["SECRET_KEY"] = "doi-thanh-bien-moi-truong"
@app.route("/cart/add/<int:product_id>")
def add_to_cart(product_id):
cart = session.get("cart", [])
cart.append(product_id)
session["cart"] = cart
return {"cart": cart}

Giải pháp: chuyển session lên Redis bằng Flask-Session

Cài hai package, thêm vài dòng cấu hình — code dùng session giữ nguyên. Flask-Session thay session interface mặc định bằng RedisSessionInterface: dữ liệu lưu trong Redis dưới key session:<id>, cookie trình duyệt chỉ chứa session id.

pip install flask-session redis
from datetime import timedelta
from flask import Flask, session
from flask_session import Session
from redis import Redis
app = Flask(__name__)
app.config["SECRET_KEY"] = "doi-thanh-bien-moi-truong"
app.config["SESSION_TYPE"] = "redis"
app.config["SESSION_REDIS"] = Redis.from_url("redis://127.0.0.1:6379")
app.config["PERMANENT_SESSION_LIFETIME"] = timedelta(days=7)
Session(app)
@app.route("/cart/add/<int:product_id>")
def add_to_cart(product_id):
cart = session.get("cart", [])
cart.append(product_id)
session["cart"] = cart
return {"cart": cart}
@app.route("/cart")
def view_cart():
return {"cart": session.get("cart", [])}
@app.route("/logout")
def logout():
session.clear()
return "Da dang xuat"

Đo lại với cùng giỏ hàng: cookie chỉ còn 108 ký tự, vì nó chỉ mang session id. Redis tự xóa key hết hạn nhờ TTL theo PERMANENT_SESSION_LIFETIME (mặc định 31 ngày, ví dụ trên rút xuống 7 ngày). Lưu ý: dữ liệu session phải serialize được (msgpack là định dạng mặc định từ Flask-Session 0.7.0, chỉ nhận kiểu đơn giản như dict, list, str, số); chưa có Redis ở máy dev thì dùng tạm backend cachelib với FileSystemCache rồi đổi sang Redis khi deploy.

Áp dụng vào dự án của bạn

Hãy chuyển sang Flask-Session khi session chứa giỏ hàng, form nhiều bước hoặc dữ liệu tạm lớn hơn vài trăm byte — đó là lúc cookie mặc định sắp chạm giới hạn. Nó cũng đúng khi cần thu hồi session từ phía server: đăng xuất khỏi mọi thiết bị chỉ là xóa key session:<id> trong Redis, thay vì chờ cookie hết hạn. Khi logout, nhớ gọi session.clear() để xóa cả dữ liệu trên Redis. Cuối cùng, khóa Redis lại: chỉ bind localhost, đặt mật khẩu, không expose port 6379 ra internet.

Bài viết liên quan

Câu hỏi thường gặp

Flask-Session có đổi cách dùng session không?

Không. Bạn vẫn dùng flask.session như cũ — gán, đọc, xóa y hệt, vì Flask-Session chỉ thay chỗ lưu trữ phía dưới.

Không có Redis thì làm sao?

Dùng tạm backend cachelib với FileSystemCache, chỉ đổi SESSION_TYPE thành 'cachelib'. Production dùng Redis hoặc Memcached; backend SQLAlchemy cũng được nhưng phải tự dọn session hết hạn bằng lệnh flask session_cleanup.

Session lưu Redis có an toàn hơn cookie không?

Có: dữ liệu không còn nằm trong tay người dùng nên không bị đọc trộm hay sửa. Nhưng phải bảo vệ Redis: bind localhost, đặt mật khẩu, không expose port 6379. SECRET_KEY vẫn cần mạnh, vì ai đoán được session id là chiếm được session.

Session hết hạn khi nào?

Mặc định sau 31 ngày, theo PERMANENT_SESSION_LIFETIME. Redis tự xóa key hết hạn nhờ TTL nên không cần dọn tay. SESSION_PERMANENT=False thì cookie bị xóa khi đóng trình duyệt, nhưng dữ liệu trên server vẫn tồn tại đến hết TTL — cứ giữ mặc định True.

💬 Bạn đã thử cách này trong dự án của mình chưa? Nếu gặp lỗi hoặc có cách làm gọn hơn, để lại bình luận bên dưới — mình đọc hết và sẽ bổ sung những ý hay vào bài.

Nguồn tham khảo