Khi bạn tạo một Thread mới từ trong view Flask, thread đó không có request context nên chạm vào request, g hay session sẽ nổ RuntimeError. Hàm copy_current_request_context của Flask sao chép toàn bộ context của request hiện tại sang thread nền, để code trong thread vẫn đọc được dữ liệu request như thể đang chạy trong view. Dùng nó mỗi khi cần xử lý nặng sau khi đã trả response — gửi email, ghi audit log, gọi webhook — mà không bắt client chờ.

Vấn đề

Giả sử endpoint /report nhận yêu cầu xuất báo cáo: bạn muốn trả về 202 ngay lập tức rồi xuất file trong thread nền, để client không phải chờ. Code kiểu này nhìn qua tưởng ổn:

from threading import Thread
from flask import Flask, request
app = Flask(__name__)
@app.route("/report")
def report():
def send_report():
user = request.args.get("user") # nổ lỗi ở đây
print(f"Xuất báo cáo cho {user}")
Thread(target=send_report).start()
return {"status": "dang xu ly"}, 202

Nhưng send_report chạy trong một thread hoàn toàn mới, không có request context gắn kèm. Flask tạo request context cho đúng thread đang xử lý request, nên dòng request.args.get(“user”) trong thread nền sẽ nổ RuntimeError: Working outside of request context. Khó chịu hơn, lỗi chỉ nổ khi thread thực sự chạy — thường là sau khi response đã trả về — nên lúc test bằng tay bạn dễ tưởng mọi thứ chạy ngon, tới khi chạy thật trên production mới thấy log báo lỗi.

Giải pháp

Chỉ cần bọc hàm nền bằng decorator copy_current_request_context trước khi đưa vào Thread:

from threading import Thread
from flask import Flask, copy_current_request_context, request
app = Flask(__name__)
@app.route("/report")
def report():
@copy_current_request_context
def send_report():
user = request.args.get("user") # đọc bình thường
print(f"Xuất báo cáo cho {user}")
Thread(target=send_report).start()
return {"status": "dang xu ly"}, 202

Decorator chụp lại request context hiện tại ngay lúc định nghĩa hàm, và khi thread chạy nó sẽ push context đó vào thread. Nhờ vậy request.args, request.path hay request.headers đều đọc được bình thường. Vì request context đã bao gồm app context nên current_app và app.config cũng dùng được trong thread.

Ba lưu ý quan trọng:

  • g trong thread là một đối tượng mới: giá trị bạn gán cho g trong view không sang được thread, và ngược lại. Cần dữ liệu gì thì truyền rõ ràng qua tham số hàm.
  • Chỉ đọc dữ liệu request trong thread, đừng ghi session rồi mong trình duyệt nhận — response đã trả về từ trước khi thread chạy.
  • Nếu hàm nền chỉ cần config mà không cần dữ liệu request, dùng app.app_context() nhẹ hơn — xem bài Flask-Mail đã dùng cách này.

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

Gắn mẫu này vào endpoint xuất file, gửi email xác nhận sau đăng ký, ghi audit log khi user đổi mật khẩu, hoặc gọi webhook sang hệ thống khác. Quy trình chung: view validate dữ liệu đầu vào, trả 202 ngay, thread nền làm phần nặng. Nếu traffic cao, đừng spawn Thread trần cho mỗi request — dùng ThreadPoolExecutor với số worker giới hạn để khỏi ăn hết RAM.

Bài viết liên quan

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

copy_current_request_context khác gì app_context()?

copy_current_request_context sao chép cả request context, nên trong thread đọc được request, g và current_app. app_context() chỉ tạo app context, không có request — chạm vào request vẫn nổ RuntimeError.

Dùng được với ThreadPoolExecutor không?

Được. Bọc hàm bằng decorator rồi submit như thường; mỗi task nhận một bản sao context của request đã submit nó.

Trong thread nền có dùng được current_app không?

Được, vì request context đã bao gồm app context. Bạn đọc được current_app.config hay current_app.logger trong thread nền mà không cần làm gì thêm.

Khi nào không nên dùng Thread mà nên dùng Celery hoặc RQ?

Khi tác vụ dài hơn vài giây, cần retry khi lỗi, hoặc cần sống sót qua restart server. Thread nền chết cùng process và không có hàng đợi bền vững — chỉ hợp việc nhanh, ít quan trọng như gửi email hay ghi log.

💬 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