Module warnings trong Python: cảnh báo, DeprecationWarning
Bài 9/10 · Chương 16
Code sạch, kiểm thử và gỡ lỗi
- 7 phút
- Trung cấp
- Python 3.14
- Cập nhật
Trong bài này · 11
Module warnings trong Python dùng để phát cảnh báo: chương trình in một dòng nhắc rằng có gì đó lạ hay sắp bị bỏ, rồi vẫn chạy tiếp, khác với lỗi làm chương trình dừng. Bạn cần nó khi hàm tính tiền nhận một đơn 25 ly: có thể đúng, có thể gõ nhầm, nên nhắc người dùng kiểm lại thay cho từ chối đơn.
Cần biết trước: lệnh import, raise và logging.
Phát cảnh báo bằng warnings.warn()
warnings.warn("lời nhắc") phát một cảnh báo loại UserWarning. Python in cảnh báo ra stderr, luồng dành cho thông báo lỗi, rồi chạy tiếp dòng sau. Để đọc cảnh báo ngay trong chương trình, ví dụ gom chúng bằng warnings.catch_warnings(record=True): trong khối with, mỗi cảnh báo thành một mục của list ds.
import warnings
def gia_ly(gia, so_ly):
if so_ly > 20:
warnings.warn("Đơn hơn 20 ly, kiểm lại số lượng")
return gia * so_ly
with warnings.catch_warnings(record=True) as ds:
warnings.simplefilter("always")
print(gia_ly(29000, 25))
for w in ds:
print(w.category.__name__, w.message)KẾT QUẢ
725000
UserWarning Đơn hơn 20 ly, kiểm lại số lượngHàm vẫn trả về 725000: cảnh báo không chặn kết quả. w.category là loại cảnh báo, w.message là lời nhắc. simplefilter("always") cho cảnh báo hiện ở từng lần phát, giải thích ở mục sau. Đổi 25 thành 20 rồi chạy lại: dòng UserWarning không còn, vì 20 ly chưa vượt mốc.
Khi chạy không có catch_warnings, terminal hiện dòng cảnh báo bắt đầu bằng đường dẫn đầy đủ của file, như …/hoa_don.py:5: UserWarning: Đơn hơn 20 ly, kiểm lại số lượng, kèm dòng code đã phát nó. Trên trang này dòng đó hiện trong phần stderr của kết quả.
DeprecationWarning: báo một thứ sắp bị bỏ
Khi một hàm sắp bị bỏ, thư viện phát DeprecationWarning để người dùng kịp đổi sang cách mới. Bạn tự viết được như vậy: truyền loại cảnh báo làm tham số thứ hai, và stacklevel=2 để dòng cảnh báo chỉ vào chỗ gọi hàm thay cho dòng bên trong hàm. Lưu đoạn sau vào hoa_don.py:
import warnings
def tinh_tien(gia, so_ly):
warnings.warn("tinh_tien() sắp bị bỏ, dùng gia_ly()",
DeprecationWarning, stacklevel=2)
return gia * so_ly
print(tinh_tien(29000, 2))
Chạy trong terminal (Windows gõ python, macOS/Linux gõ python3). Một lần chạy thật bằng Python 3.14, ngày 15/11/2026:
python3 hoa_don.pyKẾT QUẢ
/home/hocvien/hoc-python/hoa_don.py:10: DeprecationWarning: tinh_tien() sắp bị bỏ, dùng gia_ly()
print(tinh_tien(29000, 2))
58000Dòng đầu ghi đường dẫn file (trên máy bạn khác), số dòng 10 (dòng gọi tinh_tien, nhờ stacklevel=2), loại cảnh báo và lời khuyên. Dòng thứ hai là chính dòng code đó. Python 3.12 in giống hệt. Python mặc định ẩn DeprecationWarning phát ra từ bên trong một module được import, và chỉ hiện khi code ở file bạn đang chạy gây ra nó. Muốn thấy cả cảnh báo của thư viện, chạy với cờ -W default.
Lọc cảnh báo
Bộ lọc quyết định làm gì với một cảnh báo: "default" hiện một lần cho mỗi chỗ phát, "always" hiện ở từng lần phát, "ignore" bỏ qua, "error" biến cảnh báo thành lỗi. warnings.simplefilter() đặt lọc cho tất cả cảnh báo, warnings.filterwarnings("ignore", category=DeprecationWarning) chỉ lọc một loại. Đặt lọc trong khối with warnings.catch_warnings(): thì khi ra khỏi khối, các bộ lọc cũ trở lại:
import warnings
def gia_ly(gia, so_ly):
if so_ly > 20:
warnings.warn("Đơn hơn 20 ly, kiểm lại số lượng")
return gia * so_ly
with warnings.catch_warnings():
warnings.simplefilter("error")
try:
gia_ly(29000, 25)
except UserWarning as loi:
print("Bắt được:", loi)KẾT QUẢ
Bắt được: Đơn hơn 20 ly, kiểm lại số lượng"error" hay dùng trong test: một cảnh báo bị bỏ sót thành một lỗi mà test bắt được. Trên trang này module warnings giữ bộ lọc giữa các lần bấm Chạy, nên các ví dụ đặt lọc trong catch_warnings(). Ngoài code, cờ -W của lệnh python đặt lọc cho cả lần chạy:
python3 -W ignore::DeprecationWarning hoa_don.pyKẾT QUẢ
58000Cờ -W error thì làm hoa_don.py dừng như gặp lỗi, với dòng cuối là chính lời cảnh báo DeprecationWarning. Biến môi trường PYTHONWARNINGS nhận cùng giá trị:
Windows (PowerShell):
$env:PYTHONWARNINGS = "error"
python hoa_don.py
macOS/Linux:
PYTHONWARNINGS=error python3 hoa_don.py
Kiểm tra nhanh
Terminal in dòng
hoa_don.py:10: DeprecationWarning: tinh_tien() sắp bị bỏ, dùng gia_ly(). Dòng đó nói gì?- Chương trình đã dừng ở dòng 10 vì lỗi
- Dòng 10 gọi một hàm sắp bị bỏ, chương trình vẫn chạy tiếp
- Hàm
gia_ly()không còn dùng được
Hàm gặp một đơn 25 ly: có thể đúng, có thể gõ nhầm, và hàm vẫn phải tính tiếp. Nên viết dòng nào?
warnings.warn("Đơn hơn 20 ly, kiểm lại số lượng")raise UserWarning("Đơn hơn 20 ly, kiểm lại số lượng")raise ValueError("Đơn hơn 20 ly, kiểm lại số lượng")
Những câu nào đúng về
with warnings.catch_warnings(): warnings.simplefilter("ignore")?- Trong khối, các cảnh báo không hiện ra
- Ra khỏi khối, các bộ lọc cũ trở lại
- Trong khối,
raise ValueError(...)cũng bị bỏ qua - Ra khỏi khối, mọi cảnh báo sau đó vẫn bị bỏ qua
Trong khung bẫy đếm cảnh báo, đổi
"default"thành"always"rồi chạy lại. Dòngprint(len(ds))in ra gì?103
Bài tập
Kiểm số ly trong một đơn
Viết hàm kiem_don(cac_mon): cac_mon là dict tên món sang số ly. Duyệt các món theo thứ tự trong dict. Món có số ly nhỏ hơn hoặc bằng 0 là dữ liệu sai: ném ValueError(f"{ten}: số ly phải dương"). Món hơn 20 ly là chuyện lạ nhưng vẫn tính: gọi warnings.warn(f"{ten}: {so_ly} ly, kiểm lại số lượng"), loại mặc định UserWarning. Hàm trả về tổng số ly của đơn. Hàm không in gì và không sửa cac_mon.
Ví dụ: kiem_don({"cà phê sữa": 2, "bạc xỉu": 25}) phát một cảnh báo bạc xỉu: 25 ly, kiểm lại số lượng và trả về 27.
Trả về: tổng số ly, một int.
import warnings
def kiem_don(cac_mon):
pass # Viết thân hàm thay cho dòng nàyTóm tắt
warnings.warn("...")phát cảnh báoUserWarningrồi chạy tiếp;raisethì dừng chương trình.Tham số thứ hai chọn loại cảnh báo, như
DeprecationWarningcho hàm sắp bị bỏ.stacklevel=2làm dòng cảnh báo chỉ vào chỗ gọi hàm.Bộ lọc:
"default"hiện một lần mỗi chỗ,"always","ignore","error".Đặt lọc trong
with warnings.catch_warnings():để bộ lọc cũ trở lại khi ra khỏi khối.Ngoài code: cờ
-Wcủa lệnhpythonhay biến môi trườngPYTHONWARNINGS.
Câu hỏi thường gặp
DeprecationWarning trong Python có nguy hiểm không?
Chưa: code vẫn chạy đúng ở bản hiện tại. Nhưng thứ bị đánh dấu sẽ bị bỏ ở một bản sau, và khi đó code báo lỗi thật. Đọc lời khuyên trong cảnh báo và đổi sang cách mới sớm, trước khi nâng cấp thư viện hay Python.
Tắt hết warnings Python có nên không?
Chỉ tắt cảnh báo bạn đã đọc và biết vì sao nó xuất hiện, và tắt đúng loại đó bằng filterwarnings("ignore", category=...). Tắt hết bằng -W ignore giấu cả những cảnh báo mới, trong đó có thể có cảnh báo về chỗ sắp hỏng.
Cảnh báo khác ghi log ở chỗ nào?
Cảnh báo dành cho người viết code: nó chỉ vào dòng code cần sửa và mặc định chỉ hiện một lần. Log của module logging dành cho người vận hành chương trình: mỗi việc một dòng, có mức và thời gian. Hàm logging.captureWarnings(True) chuyển cảnh báo vào log khi bạn muốn cả hai ở một chỗ.
Làm sao cho test báo lỗi khi code còn phát warnings Python?
Chạy test với python -W error -m unittest, hoặc đặt warnings.simplefilter("error") trong catch_warnings() của test. Một cảnh báo khi đó thành lỗi, nên test sai ngay và bạn biết dòng nào cần sửa.
Chủ đề
Bài này có hữu ích?
Hỏi đáp
Tham vấn chuyên môn
Nhà sáng lập AIDev và VietPlatform · Thạc sĩ AI MSE
- Tốt nghiệp thủ khoa xuất sắc Thạc sĩ AI MSE.
- Đồng sáng lập, CTO E-University, SVOnline: số hóa 10+ đại học, 40.000+ sinh viên.
- Xây hệ thống AI cho doanh nghiệp tại VietPlatform.