Khi form HTML gửi lên Flask, mọi giá trị nằm trong request.form — một dict đặc biệt có thể chứa nhiều giá trị cho cùng một key. Dùng request.form.get() cho giá trị đơn, request.form.getlist() cho checkbox hoặc multi-select, và request.form.get("age", type=int) để ép kiểu an toàn. Nhớ ba hàm này là đọc đúng mọi form.
Vấn đề
Xét form đăng ký với ba trường: tên (text), tuổi (number) và chủ đề quan tâm (checkbox chọn nhiều). Code đọc kiểu này sẽ lặng lẽ làm mất dữ liệu:
from flask import Flask, requestapp = Flask(__name__)@app.route("/register", methods=["POST"])def register(): name = request.form["name"] age = int(request.form["age"]) # no ValueError neu nhap chu topics = request.form.get("topics") # chi lay duoc 1 gia tri dau tien return f"{name} ({age}) chon: {topics}"
Có ba lỗi trong đoạn code ngắn này. Thứ nhất, trình duyệt gửi topics=python&topics=flask&topics=django, nhưng .get() chỉ trả giá trị đầu tiên là "python" — hai lựa chọn còn lại biến mất mà không có cảnh báo nào. Thứ hai, mọi giá trị trong form đều là chuỗi, nên int(request.form["age"]) nổ ValueError và trả lỗi 500 khi người dùng gõ chữ vào ô tuổi. Thứ ba, request.form["name"] nổ lỗi khi thiếu trường, thay vì cho bạn cơ hội báo lỗi đẹp.
Giải pháp
Bản sửa đúng dùng ba hàm của request.form thay cho cách đọc thủ công:
from flask import Flask, requestapp = Flask(__name__)@app.route("/register", methods=["POST"])def register(): name = request.form.get("name", "").strip() age = request.form.get("age", type=int) # None neu thieu hoac ep kieu that bai topics = request.form.getlist("topics") # lay DU moi gia tri da chon if not name or age is None: return {"error": "Thieu ten hoac tuoi khong hop le"}, 400 return {"name": name, "age": age, "topics": topics}
request.form là một ImmutableMultiDict của Werkzeug: một key có thể giữ nhiều giá trị. .get() chỉ lấy giá trị đầu tiên, còn .getlist() lấy hết — điểm khác biệt duy nhất này quyết định checkbox có bị mất dữ liệu hay không. Khi không chọn checkbox nào, getlist() trả về list rỗng [], nên vòng lặp phía sau vẫn chạy an toàn.
Tham số type=int trong .get() giúp ép kiểu ngay tại chỗ: ép thất bại thì trả về None thay vì nổ exception, và bạn chỉ cần kiểm tra age is None để trả lỗi 400 rõ ràng. Lưu ý: ép kiểu thất bại thì Flask trả về giá trị mặc định mà không báo lỗi, nên muốn phân biệt “không gửi tuổi” với “gửi tuổi sai”, hãy kiểm tra chuỗi gốc request.form.get("age") trước.
Muốn xem toàn bộ dữ liệu gửi lên, dùng request.form.to_dict(flat=False) — mỗi key map tới một list đầy đủ giá trị. Và request.form chỉ có dữ liệu khi client gửi đúng định dạng form (application/x-www-form-urlencoded hoặc multipart/form-data); nếu client gửi JSON thì nó rỗng hoàn toàn — lúc đó phải dùng request.get_json() thay thế.
Áp dụng vào dự án của bạn
Áp dụng ngay vào form đăng ký, form lọc sản phẩm hay form khảo sát: thay mọi request.form[...] bằng .get() kèm giá trị mặc định, mọi checkbox và multi-select bằng .getlist(), và mọi trường số bằng .get(..., type=int) kèm kiểm tra None. Ba thay đổi nhỏ này loại được ba lỗi hay gặp nhất khi đọc form. Khi form lớn dần và cần validate chéo hay chống CSRF, đó là lúc chuyển sang Flask-WTF thay vì viết thêm if thủ công.
Bài viết liên quan
- Flask: validate query string bằng request.args.get(type=…) — chặn giá trị sai ngay từ cổng API trong 5 phút
- Flask: đọc và validate JSON body đúng cách — hết cảnh API trả lỗi HTML với request.get_json() trong 5 phút
- Flask: validate form an toàn bằng Flask-WTF, khỏi xử lý request.form thủ công
Câu hỏi thường gặp
request.form.get() và request.form[] khác nhau thế nào?
.get() trả về None hoặc giá trị mặc định khi thiếu key, còn request.form["name"] sẽ nổ lỗi 400 khi key không tồn tại. Dùng .get() cho trường không bắt buộc, dùng [] khi muốn Flask tự trả lỗi 400 cho trường bắt buộc.
Vì sao gửi JSON mà request.form rỗng?
Vì request.form chỉ parse form-urlencoded hoặc multipart/form-data. Client gửi JSON thì đọc bằng request.get_json().
getlist() trả về gì khi không chọn checkbox nào?
Trả về list rỗng [], không phải None. Nhờ vậy code duyệt danh sách phía sau không cần kiểm tra None trước, cứ lặp bình thường là an toàn.
Ép kiểu bằng type=int thất bại thì sao?
Flask trả về None (hoặc giá trị mặc định bạn truyền vào), không nổ exception. Muốn phân biệt “không gửi” với “gửi sai”, kiểm tra chuỗi gốc request.form.get("age") trước khi ép kiểu.
💬 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
- Flask Documentation — Accessing Request Data: https://flask.palletsprojects.com/en/stable/quickstart/#accessing-request-data
- Flask API — flask.Request: https://flask.palletsprojects.com/en/stable/api/#flask.Request
- Werkzeug Documentation — MultiDict: https://werkzeug.palletsprojects.com/en/stable/datastructures/#werkzeug.datastructures.MultiDict
