Master Python Tracebacks: Decode Errors and Debug Like a Pro

What is a Traceback?

Traceback is Python's error report, similar to a stack trace in other languages. When an exception occurs, Python prints a Traceback that shows the file, line number, and the code that caused the error.

# example.py

def greet(someone):
    print('Hello, ' + someon)

greet('Chad')

The above code raises a NameError because someon is undefined. The Traceback includes the file path, line number, and the exception type.

How to read a Python Traceback

Read the Traceback from bottom to top. The last line contains the exception type and message. The lines above show the call stack, with each File line indicating the file and line where the call originated.

Blue box : the final line with the error message.

Green box : the exception name and message.

Yellow box : the call stack, deeper calls appear higher.

Red underline : the actual code line that raised the exception.

Common Python exception types

AttributeError

Raised when an attribute reference or assignment fails.

a = 1
a.b

ImportError / ModuleNotFoundError

Raised when an import fails because the module or name does not exist.

import aaa

IndexError

Raised when a sequence index is out of range.

a_list = ['a', 'b']
a_list[3]

KeyError

Raised when a dictionary key is not found.

a_dict = {}
a_dict['b']

NameError

Raised when a name is not defined.

def greet(person):
    print(f'Hello, {persn}')

greet('World')

SyntaxError

Raised for invalid Python syntax.

def greet(person)
    pass

TypeError

Raised when an operation is applied to an object of inappropriate type.

1 + '1'

ValueError

Raised when a function receives an argument of correct type but inappropriate value.

a, b, c = [1, 2]

Recording and handling errors

Use try/except blocks to catch exceptions and prevent program termination.

import requests

url = "http://urlis233.com"
try:
    response = requests.get(url)
except requests.exceptions.ConnectionError:
    print("-1", "Link error, request failed")
else:
    print(response.status_code, response.text)

For production code, log exceptions with the logging module.

import logging, requests

logger = logging.getLogger(__name__)
url = "http://urlis233.com"

try:
    response = requests.get(url)
except requests.exceptions.ConnectionError as e:
    logger.exception(e)
    print(-1, "Link error, request failed")
else:
    print(response.status_code, response.content)

Understanding Tracebacks and common exception types helps you debug Python programs efficiently.