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

KeyError trong Python: nghĩa là gì và cách sửa

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

Bài 7/13 · Chương 24

Giải nghĩa thông báo lỗi

  • 7 phút
  • Cơ bản
  • Python 3.14
  • Cập nhật

Thông báo KeyError: 'sinh tố bơ' trong Python nghĩa là chương trình tra dict bằng một khóa mà dict không có. Phần sau dấu hai chấm chính là khóa đó, in y nguyên. Bạn gặp lỗi này khi gõ sai tên khóa, sai chữ hoa, dư một dấu cách, tra bằng chuỗi '101' trong khi khóa là số 101, hay cộng dồn vào một khóa chưa từng được thêm.

Cần biết trước: dict và keys(), values(), items().

Bảng tra nhanh: nguyên nhân KeyError và cách sửa

Python gọi lỗi này là KeyError. Khác các lỗi khác, dòng cuối chỉ có tên lớp và khóa bị thiếu (trừ popitem()), không có câu giải thích. Dòng đó giống hệt nhau trên Python 3.12, 3.13, 3.14 và trên trang.

Phần sau KeyError:

Nguyên nhân

Cách sửa

'sinh tố bơ'

khóa không có trong dict

gia.get("sinh tố bơ"), hoặc kiểm tra in trước

'Trà đào'

khóa có, nhưng khác chữ hoa

gõ đúng "trà đào" như khi tạo dict

'bạc xỉu '

dư dấu cách ở cuối khóa

bỏ dấu cách thừa

'101'

tra bằng chuỗi, khóa là số 101

phong[int(so)]

'bạc xỉu' khi đếm

dem[mon] += 1 với khóa chưa có

dem[mon] = dem.get(mon, 0) + 1

'sinh tố bơ' khi xóa

del gia[...] hoặc gia.pop(...) khóa không có

kiểm tra in, hoặc gia.pop(k, None)

'Đà Lạt'

dict lồng nhau, tầng ngoài thiếu khóa

kiểm tra từng tầng

'popitem(): dictionary is empty'

popitem() trên dict rỗng

kiểm tra len(d) > 0

Hai dấu nháy quanh khóa trong thông báo giúp bạn thấy dấu cách thừa: 'bạc xỉu ' có một khoảng trắng trước dấu nháy đóng. Khóa là số thì thông báo in số đó, không có nháy. Chạy đoạn dưới để tra một khóa có thật:

python
gia = {"cà phê sữa": 29000, "bạc xỉu": 32000, "trà đào": 35000}
mon = "trà đào"
print(mon, gia[mon])
print(list(gia.keys()))

KẾT QUẢ

trà đào 35000
['cà phê sữa', 'bạc xỉu', 'trà đào']

Đổi mon = "trà đào" thành mon = "Trà đào" rồi chạy lại: Python in KeyError: 'Trà đào'. In danh sách khóa bằng keys() như dòng cuối là cách nhanh để so khóa bạn tra với khóa dict đang có. Bài mẹ của trang này, bài keys(), values(), items(), dạy cách duyệt các khóa đó.

Khóa gần đúng: chữ hoa, dấu cách, chuỗi với số

Dict so khóa từng ký tự. "Trà đào" và "trà đào" là hai chuỗi khác nhau, nên tra bằng chữ hoa thì báo lỗi:

python
gia = {"cà phê sữa": 29000, "bạc xỉu": 32000, "trà đào": 35000}
print(gia["Trà đào"])

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

text
KeyError: 'Trà đào'

Khóa chuỗi đọc từ input() hay hay dư dấu cách ở cuối, khi người dùng gõ thêm một phím cách trước Enter. Khóa là số thì tra bằng chuỗi cũng hỏng, dù trông giống nhau:

python
phong = {101: "Lan", 102: "Minh"}
so = "101"
print(phong[so])

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

text
KeyError: '101'

Nháy đơn quanh 101 trong thông báo cho biết khóa đã tra là chuỗi. Sửa bằng phong[int(so)].

Đếm bằng dict: dem[mon] += 1 báo KeyError

+= đọc giá trị cũ trước khi cộng. Ở lần đầu gặp một món, khóa chưa có trong dict nên chưa có giá trị cũ để đọc:

python
dem = {}
for mon in ["bạc xỉu", "trà đào", "bạc xỉu"]:
    dem[mon] += 1

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

text
KeyError: 'bạc xỉu'

get(mon, 0) trả về 0 khi khóa chưa có, nên dòng đếm chạy được ngay từ lượt đầu:

python
dem = {}
for mon in ["bạc xỉu", "trà đào", "bạc xỉu"]:
    dem[mon] = dem.get(mon, 0) + 1
print(dem)

KẾT QUẢ

{'bạc xỉu': 2, 'trà đào': 1}

Python còn hai cách khác cho mẫu này. setdefault() thêm khóa với giá trị ban đầu nếu khóa chưa có, bài nhóm dữ liệu theo khóa dùng nó để gom học viên theo lớp. defaultdict là một dict tự tạo giá trị ban đầu cho từng khóa mới, nên dem[mon] += 1 chạy được ngay.

Tra an toàn: get() và in

Tra bằng ngoặc vuông một khóa không có thì chương trình dừng:

python
gia = {"cà phê sữa": 29000, "bạc xỉu": 32000, "trà đào": 35000}
print(gia["sinh tố bơ"])

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

text
KeyError: 'sinh tố bơ'

get() trả về None, hoặc giá trị mặc định bạn truyền vào, thay cho báo lỗi. in trả lời khóa có trong dict hay không:

python
gia = {"cà phê sữa": 29000, "bạc xỉu": 32000, "trà đào": 35000}
print(gia.get("sinh tố bơ"))
print(gia.get("sinh tố bơ", 0))
print("sinh tố bơ" in gia, "bạc xỉu" in gia)

KẾT QUẢ

None
0
False True

Dùng in khi chương trình cần làm việc khác cho khóa thiếu, như báo "món này hết". Dùng get() khi một giá trị mặc định là đủ. Xóa khóa cũng có cách không báo lỗi: gia.pop("sinh tố bơ", None) trả về None khi khóa không có, bài phương thức của dict có đủ các phương thức này.

Kiểm tra nhanh

  1. Với gia = {"trà đào": 35000, 101: "Lan"}, những lần tra nào báo KeyError?

    • gia["Trà đào"]
    • gia[101]
    • gia["101"]
    • gia.get("trà sữa")
  2. Với dem = {}, dòng dem["trà đào"] += 1 báo gì?

    • Không lỗi, dem thành {'trà đào': 1}
    • Báo KeyError với khóa 'trà đào'
    • TypeError
  3. Trong khung bẫy dùng get(mon, 0), chương trình in gì?

    • Báo lỗi KeyError
    • 67000
    • 32000
Đúng hết lần đầu +15 XP

Bài tập

Đếm món, tính tiền và tách món không có trong menu

gia là menu của quán, don là các món khách gọi trong buổi sáng. Dòng trong comment của starter đếm số lần gọi nhưng báo KeyError. Duyệt don và viết:

  • dem: số lần gọi mỗi món, kể cả món không có trong menu, đếm bằng dem.get().

  • tong: tổng tiền các món có trong menu, chọn bằng câu lệnh if.

  • khong_co: các món không có trong menu, theo thứ tự gọi, thêm bằng .append().

python
# for mon in don: dem[mon] += 1
gia = {"cà phê sữa": 29000, "bạc xỉu": 32000, "trà đào": 35000}
don = ["bạc xỉu", "trà đào", "bạc xỉu",
       "sinh tố bơ", "cà phê sữa", "bạc xỉu"]
dem = {}
tong = 0
khong_co = []
# Viết code của bạn dưới dòng này

Tóm tắt

  • KeyError kèm một khóa trong nháy nghĩa là dict không có khóa đó; khóa được in y nguyên, kể cả dấu cách.

  • Khóa phải khớp từng ký tự và đúng kiểu: 'Trà đào' khác 'trà đào', '101' khác 101.

  • dem[mon] += 1 báo lỗi ở lần đầu gặp món; dùng dem.get(mon, 0) + 1.

  • get() trả None hoặc giá trị mặc định thay cho báo lỗi, in cho biết khóa có hay không.

  • setdefault() và defaultdict là hai cách khác để có giá trị ban đầu cho khóa mới.

  • get(k, 0) che mất khóa gõ sai: cần báo lại khóa thiếu thì kiểm tra bằng in.

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

Lỗi KeyError là gì trong Python?

Đó là lỗi Python báo khi bạn tra, xóa hay cộng dồn vào một khóa mà dict không có. Dòng thông báo chỉ ghi khóa đó, nên việc đầu tiên là so khóa trong thông báo với list(d.keys()). Cách tạo và tra dict nằm ở bài dict.

Nên dùng get() hay kiểm tra in để tránh KeyError?

Dùng get() khi khóa thiếu chỉ cần một giá trị thay thế, như đếm từ 0. Dùng if k in d: khi khóa thiếu là chuyện cần xử lý riêng, như báo món hết hàng. Cả hai đều không làm thay đổi dict.

Vì sao khóa có trong dict mà vẫn báo KeyError?

Thường là khóa gần giống chứ không trùng: khác chữ hoa, dư dấu cách, có dấu và không dấu, hay chuỗi '101' so với số 101. Nhìn kỹ phần trong nháy của thông báo, rồi in list(d.keys()) để so. Bài keys(), values(), items() chỉ cách duyệt các khóa.

Xóa phần tử không có trong set bằng remove() có báo KeyError không?

Có, remove() của set báo KeyError kèm phần tử không có trong set, cùng dạng với dict. Bài thêm, xóa phần tử của set giới thiệu discard(), cách xóa không báo lỗi. Chỉ số vượt khỏi list là lỗi khác, có ở trang IndexError.

Chủ đề

keyerror 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