Bỏ qua đến nội dung chính
Mục lục

Module warnings trong Python: cảnh báo, DeprecationWarning

AIDev Team · duyệt: Nguyễn Việt Chung

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

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.

python
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ượng

Hà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:

python
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:

bash
python3 hoa_don.py

KẾ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))
58000

Dò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:

python
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:

bash
python3 -W ignore::DeprecationWarning hoa_don.py

KẾT QUẢ

58000

Cờ -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):

bash
$env:PYTHONWARNINGS = "error"
python hoa_don.py

macOS/Linux:

bash
PYTHONWARNINGS=error python3 hoa_don.py

Kiểm tra nhanh

  1. 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
  2. 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")
  3. 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
  4. Trong khung bẫy đếm cảnh báo, đổi "default" thành "always" rồi chạy lại. Dòng print(len(ds)) in ra gì?

    • 1
    • 0
    • 3
Đúng hết lần đầu +15 XP

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.

python
import warnings

def kiem_don(cac_mon):
    pass  # Viết thân hàm thay cho dòng này

Tóm tắt

  • warnings.warn("...") phát cảnh báo UserWarning rồi chạy tiếp; raise thì dừng chương trình.

  • Tham số thứ hai chọn loại cảnh báo, như DeprecationWarning cho hàm sắp bị bỏ.

  • stacklevel=2 là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ờ -W của lệnh python hay biến môi trường PYTHONWARNINGS.

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ủ đề

warnings python

Bài này có hữu ích?

Hỏi đáp

Đang tải câu hỏi…

Tham vấn chuyên môn

Nguyễn Việt Chung

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.
Biên soạn: AIDev Team · Rà soát · Quy trình biên tập