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

FutureWarning trong pandas: đọc cảnh báo và sửa code cũ

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

Bài 12/13 · Chương 10

Giải nghĩa lỗi và cảnh báo

  • 7 phút
  • Trung cấp
  • Python 3.14
  • Cập nhật

FutureWarning trong pandas là lời báo trước rằng một cách viết bạn đang dùng sẽ đổi hành vi hay bị bỏ ở bản sau; chương trình vẫn chạy tiếp và cho kết quả như cũ. Trên pandas 3, phần lớn các FutureWarning của pandas 2 đã thành lỗi thật, và cảnh báo mới về cách viết sắp bỏ là lớp Pandas4Warning, một loại DeprecationWarning.

Cần biết trước: đổi kiểu bằng astype và cảnh báo trong Python.

Bảng tra nhanh: cảnh báo của pandas và việc cần làm

Python gọi chung các lời báo này là cảnh báo (Warning), khác với lỗi ở chỗ chương trình không dừng. Bài cảnh báo trong Python kể các lớp cảnh báo chuẩn; pandas thêm lớp riêng:

Lớp cảnh báo

Nghĩa

Việc cần làm

FutureWarning

hành vi sẽ đổi ở bản sau

viết lại theo gợi ý trong câu cảnh báo

Pandas4Warning

cách viết sẽ bị bỏ ở pandas 4

viết lại ngay, trước khi nâng bản

DeprecationWarning

lớp chuẩn của Python mà Pandas4Warning kế thừa

như trên

UserWarning

pandas nghi bạn dùng sai, như đọc ngày không khai format=

đọc câu cảnh báo, khai rõ tham số

Một cảnh báo in ra hai dòng: dòng đầu có tên file, số dòng gây ra cảnh báo, tên lớp và câu cảnh báo; dòng sau chép lại chính dòng code đó. Đọc theo thứ tự: dòng code nào, lớp gì, sẽ đổi gì.

Bắt cảnh báo để đọc từng phần

Cảnh báo in ra luồng lỗi chứ không qua print, nên muốn đọc nó trong chương trình thì bắt bằng warnings.catch_warnings(record=True). Mỗi cảnh báo bắt được có category (lớp), message (câu) và lineno (số dòng gây ra):

python
import warnings
import pandas as pd

gia = pd.Series([45000, 32000])
with warnings.catch_warnings(record=True) as bat:
    warnings.simplefilter("always")
    gia_thuc = gia.astype(float, copy=False)
canh_bao = bat[0]
print(canh_bao.category.__name__)
print(str(canh_bao.message).split(". ")[0])

KẾT QUẢ

Pandas4Warning
The copy keyword is deprecated and will be removed in a future version

canh_bao.lineno cho số dòng của lệnh astype(float, copy=False) trong khối code. Câu cảnh báo nói tham số copy sẽ bị bỏ: pandas 3 đã tự hoãn việc chép dữ liệu tới khi cần (Copy-on-Write), nên tham số này không còn tác dụng. Sửa bằng cách xóa nó, gia.astype(float).

lineno trỏ vào code của bạn chứ không vào bên trong pandas, vì pandas báo cảnh báo ngược lên tới dòng đầu tiên nằm ngoài thư viện. Đổi copy=False thành copy=True rồi chạy lại: dòng đầu vẫn in Pandas4Warning, vì cảnh báo nói về tham số chứ không về giá trị của nó.

Pandas4Warning là một DeprecationWarning

Pandas4Warning không kế thừa FutureWarning mà kế thừa DeprecationWarning của Python, qua hai lớp trung gian của pandas:

python
import pandas as pd

lop = pd.errors.Pandas4Warning
print([c.__name__ for c in lop.__mro__][:4])
print(issubclass(lop, DeprecationWarning),
      issubclass(lop, FutureWarning))

KẾT QUẢ

['Pandas4Warning', 'PandasDeprecationWarning', 'PandasChangeWarning', 'DeprecationWarning']
True False

Python chỉ hiện DeprecationWarning khi nó sinh ra từ chính file bạn chạy. Gọi qua một hàm trong module khác thì cảnh báo bị giấu đi; chạy python -W default hay đặt warnings.simplefilter("default") để thấy hết.

FutureWarning của pandas 2 thành lỗi trên pandas 3

Code trên mạng viết cho pandas 2 có nhiều dòng từng chỉ in FutureWarning. Trên pandas 2.2, s.fillna(method="ffill") in FutureWarning: Series.fillna with 'method' is deprecated and will raise in a future version. Use obj.ffill() or obj.bfill() instead.; pandas 3 thực hiện đúng lời báo đó:

python
import pandas as pd

s = pd.Series([1.0, None, 3.0])
s.fillna(method="ffill")

Dòng cuối của thông báo lỗi:

text
TypeError: NDFrame.fillna() got an unexpected keyword argument 'method'

Python gọi lỗi này là TypeError: hàm không nhận tham số tên method nữa. Câu FutureWarning cũ đã chỉ sẵn cách sửa, s.ffill(), như bài fillna(). Mã tần suất "M" cũng vậy: pandas 2.2 in FutureWarning: 'M' is deprecated and will be removed in a future version, please use 'ME' instead., còn pandas 3 dừng hẳn:

ffill() điền ô thiếu bằng giá trị gần nhất phía trên; limit= giới hạn số ô liền nhau được điền:

python
import pandas as pd

s = pd.Series([1.0, None, None, 3.0])
print(s.ffill().to_list())
print(s.ffill(limit=1).to_list())

KẾT QUẢ

[1.0, 1.0, 1.0, 3.0]
[1.0, 1.0, nan, 3.0]

Bài sửa code pandas cũ có bảng đầy đủ các cách viết cũ và cách viết mới.

Kiểm tra nhanh

  1. Sau import pandas as pd và s = pd.Series([1.0, None]), s.fillna(method="ffill") báo lỗi gì?

    • Báo lỗi TypeError
    • Báo lỗi KeyError
    • Báo lỗi AttributeError
  2. Sau import pandas as pd, lệnh print(issubclass(pd.errors.Pandas4Warning, FutureWarning)) in ra gì?

    • True
    • False
    • Pandas4Warning
  3. Trên pandas 2, một dòng code chỉ in FutureWarning. Bạn nâng lên pandas 3 mà chưa sửa. Điều gì có thể xảy ra?

    • Không có gì, vì cảnh báo không làm chương trình dừng
    • Dòng đó báo lỗi, hoặc chạy nhưng cho kết quả khác
    • pandas 3 tự viết lại dòng đó theo cách mới
Đúng hết lần đầu +15 XP

Bài tập

Viết lại cách điền xuôi của code cũ

Code cũ viết s.fillna(method="ffill", limit=gioi_han) để điền ô thiếu của một cột số bằng giá trị gần nhất phía trên. Viết thân hàm dien_tiep(s, gioi_han) cho pandas 3: trả về Series mới, mỗi đoạn ô thiếu liền nhau chỉ được điền tối đa gioi_han ô đầu, các ô còn lại vẫn thiếu. Ô thiếu ở đầu Series không có giá trị phía trên nên vẫn thiếu.

Series trả về giữ index và tên của s. Hàm không sửa Series s của nơi gọi.

Trả về: Series đã điền, một Series.

python
import pandas as pd

def dien_tiep(s, gioi_han):
    pass  # Viết thân hàm thay cho dòng này

Tóm tắt

  • FutureWarning báo trước một thay đổi ở bản sau; chương trình vẫn chạy và kết quả chưa đổi.

  • Một cảnh báo cho biết ba điều: dòng code gây ra (số dòng và dòng chép lại), lớp cảnh báo, và việc sẽ đổi.

  • Bắt cảnh báo bằng warnings.catch_warnings(record=True) để đọc category, message, lineno.

  • pandas 3 báo cách viết sắp bỏ bằng Pandas4Warning, một DeprecationWarning, như tham số copy= của astype().

  • Nhiều FutureWarning của pandas 2 đã thành lỗi trên pandas 3: fillna(method=) thành ffill(), "M" thành "ME".

  • Đừng tắt mọi cảnh báo; sửa code theo câu cảnh báo khi nó còn là cảnh báo.

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

Có cần sửa ngay khi thấy FutureWarning không?

Nên sửa ngay, vì câu cảnh báo đã chỉ rõ cách viết mới và việc sửa thường chỉ là một dòng. Để tới khi nâng bản thì chỗ đó thành lỗi, hay tệ hơn là cho kết quả khác mà không báo. Bài viết pandas 3 có gì mới kể các thay đổi lớn của bản 3.

Làm sao biến cảnh báo thành lỗi để tìm hết chỗ cần sửa?

Đặt warnings.simplefilter("error") ở đầu chương trình: mọi cảnh báo sẽ dừng chương trình như một lỗi, kèm traceback trỏ đúng dòng. Bài cảnh báo trong Python chỉ cách lọc theo lớp cảnh báo.

Vì sao code cũ trên mạng dùng astype(..., copy=False)?

Trên pandas 2, copy=False tránh chép dữ liệu khi đổi kiểu để tiết kiệm bộ nhớ. pandas 3 bật Copy-on-Write nên tự hoãn việc chép, tham số này thành thừa; xóa nó đi là đủ, như bài đổi kiểu bằng astype.

Chủ đề

futurewarning pandas

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