Sửa lỗi 'ValueError: invalid literal for int() with base 10' trong Python

Giải thích lỗi

Python đưa ra lỗi này khi hàm int() gặp một chuỗi mà nó không nhận diện được là số nguyên hệ cơ số 10. Hãy coi đó là một lỗi biên dịch dữ liệu. Bạn đang yêu cầu Python biến một giá trị như "apple" hoặc "12.5" thành một số nguyên, nhưng nó chỉ biết cách xử lý các chữ số thuần túy như "42" hoặc "1000".

# Dòng này sẽ gây lỗi
number = int("10.5") 
# Kết quả: ValueError: invalid literal for int() with base 10: '10.5'

Tại sao mã của bạn bị lỗi

Dữ liệu hiếm khi hoàn hảo. Bạn có thể sẽ gặp phải nút thắt cổ chai này trong bốn tình huống cụ thể sau:

- **Chuỗi số thập phân:** Ngay cả khi giá trị là `"10.0"`, dấu thập phân cũng khiến hàm khởi tạo `int()` bị bối rối.
- **Ký tự định dạng:** Dữ liệu thực tế thường bao gồm dấu phẩy (`"1,250"`) hoặc ký hiệu tiền tệ (`"$50"`) mà Python không thể tự động bỏ qua.
- **Dữ liệu đầu vào trống:** Một script đọc một dòng trống trong tệp CSV hoặc một ô văn bản trống sẽ nhận được chuỗi `""`, vốn không phải là một con số.
- **Khoảng trắng ẩn:** Đôi khi một chuỗi trông giống như `"100"` nhưng thực tế lại là `"100\n"` hoặc `" 100 "`.

Cách 1: Xử lý chuỗi số thập phân (Floats)

Nếu chuỗi của bạn trông giống như một số thập phân, int() sẽ thất bại ngay lập tức. Logic chuyển đổi của Python rất nghiêm ngặt để ngăn chặn việc mất dữ liệu ngoài ý muốn do làm tròn. Để khắc phục, hãy chuyển đổi chuỗi thành số thực (float) trước, sau đó mới ép kiểu số thực đó sang số nguyên.

price_str = "45.99"

# Phiên bản này sẽ cắt bỏ phần thập phân và trả về 45
value = int(float(price_str))
print(value) 

Cách 2: Sử dụng khối Try-Except cho dữ liệu thô

Khi bạn đang xử lý hàng nghìn hàng dữ liệu từ một API bên ngoài, bạn không thể kiểm tra thủ công từng giá trị. Việc bao bọc quá trình chuyển đổi trong khối try-except giúp ứng dụng của bạn tiếp tục chạy ngay cả khi gặp phải một bản ghi "bẩn".

raw_data = ["23", "42", "unknown", "15"]

for item in raw_data:
    try:
        age = int(item)
        print(f"Tuổi đã xử lý: {age}")
    except ValueError:
        print(f"Bỏ qua mục không hợp lệ: {item}")
        continue

Cách 3: Loại bỏ khoảng trắng và định dạng

Các ký tự ẩn là những "kẻ giết người thầm lặng" phổ biến nhất trong các script Python. Sử dụng .strip() để loại bỏ các ký tự xuống dòng vô hình hoặc khoảng trắng ở đầu/cuối thường xuất hiện khi nhập dữ liệu từ tệp.

user_input = "  500 \n"

# Làm sạch các cạnh trước khi chuyển đổi
clean_input = user_input.strip()
if clean_input:
    result = int(clean_input)
    print(result) # Kết quả: 500

Cách 4: Làm sạch ký hiệu tiền tệ và dấu phẩy

Nếu bạn đang thu thập dữ liệu từ một trang web, bạn có thể nhận được chuỗi giá như "$1,250.00". Vì int() chỉ hiểu các chữ số từ 0-9, bạn phải loại bỏ các ký tự không phải số trước.

# Tình huống: Chuyển đổi giá đã định dạng sang đơn vị cent
raw_price = "$1,250.50"

# Loại bỏ ký hiệu và dấu phẩy, sau đó chuyển đổi qua float
clean_price = raw_price.replace("$", "").replace(",", "")
price_in_cents = int(float(clean_price) * 100)

print(price_in_cents) # Kết quả: 125050

Cách 5: Kiểm tra với .isdigit()

Đối với các script đơn giản mà bạn chỉ muốn xử lý các số nguyên dương, .isdigit() là lựa chọn tốt nhất. Nó trả về giá trị boolean, cho phép bạn bỏ qua hoàn toàn việc chuyển đổi nếu chuỗi không hợp lệ.

data = "123"

if data.isdigit():
    number = int(data)
else:
    # Dòng này sẽ bắt các số âm, số thập phân và văn bản
    print("Đầu vào không phải là một số nguyên dương hợp lệ.")

Kinh nghiệm thực tế khi triển khai

- **Ghi lại lỗi (Log):** Khi việc chuyển đổi thất bại trong một tập dữ liệu lớn, hãy log lại chuỗi gây lỗi cụ thể để bạn có thể sửa nguồn dữ liệu sau này.
- **Giá trị mặc định:** Luôn quyết định một giá trị dự phòng (như `0` hoặc `None`) nếu việc chuyển đổi thất bại.
- **Kiểu dữ liệu đầu vào:** Nếu bạn đang xây dựng một ứng dụng web, hãy sử dụng HTML5 `type="number"` để ngăn người dùng gửi các chuỗi không phải số tới backend Python của bạn ngay từ đầu.