Why error handling matters in Flask

Introduction

Error handling helps your web app stay friendly and clear when things go wrong. It stops crashes and shows helpful messages instead.

When a user enters wrong data in a form

When a requested page or resource does not exist

When the server faces a problem processing a request

When external services or databases fail to respond

When you want to log errors for fixing bugs later

Syntax

Flask

from flask import Flask, jsonify

app = Flask(__name__)

@app.errorhandler(404)
def not_found(error):
    return jsonify({'error': 'Page not found'}), 404

@app.errorhandler(500)
def server_error(error):
    return jsonify({'error': 'Server error'}), 500

Use @app.errorhandler(code) to catch specific errors like 404 or 500.

Return a response with a helpful message and the error code.

Examples

This handles 404 errors by returning a JSON message.

Flask

from flask import Flask, jsonify

app = Flask(__name__)

@app.errorhandler(404)
def page_not_found(e):
    return jsonify({'error': 'This page does not exist'}), 404

This handles server errors with a friendly message.

Flask

from flask import Flask, jsonify

app = Flask(__name__)

@app.errorhandler(500)
def internal_error(e):
    return jsonify({'error': 'Oops! Something went wrong on the server.'}), 500

Sample Program

This Flask app has a homepage and a route that causes an error. It handles 404 and 500 errors by returning JSON messages instead of crashing.

Flask

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/')
def home():
    return 'Welcome to the homepage!'

@app.route('/cause-error')
def cause_error():
    # This will cause a ZeroDivisionError
    1 / 0

@app.errorhandler(404)
def not_found(error):
    return jsonify({'error': 'Page not found'}), 404

@app.errorhandler(500)
def server_error(error):
    return jsonify({'error': 'Server error occurred'}), 500

if __name__ == '__main__':
    app.run(debug=True)

Important Notes

Always handle common errors to improve user experience.

Use JSON responses for APIs and friendly HTML pages for websites.

Debug mode shows detailed errors but turn it off in production.

Summary

Error handling keeps your app stable and user-friendly.

Use @app.errorhandler to catch and respond to errors.

Show clear messages so users know what happened.

Practice

1. Why is error handling important in a Flask web application?

easy

A. It hides all errors so developers never see them.

B. It makes the app run faster by skipping checks.

C. It keeps the app stable and shows helpful messages to users.

D. It automatically fixes bugs without developer input.

Solution

1. Step 1: Understand the role of error handling

   Error handling helps prevent the app from crashing and manages unexpected problems gracefully.

2. Step 2: Recognize user experience benefits

   Showing clear messages helps users understand what went wrong instead of seeing confusing errors.

3. Final Answer:

   It keeps the app stable and shows helpful messages to users. -> Option C

4. Quick Check:

   Error handling importance = Stability and clarity [OK]

Hint: Error handling = stability + user clarity [OK]

Common Mistakes:

• Thinking error handling speeds up the app
• Believing errors should be hidden from developers
• Assuming errors fix themselves automatically

2. Which of the following is the correct way to define a custom error handler for 404 errors in Flask?

easy

A. @app.errorhandler(404)\ndef not_found(error):\n return 'Page not found', 404

B. @app.route('/404')\ndef not_found():\n return 'Page not found', 404

C. @app.handle_error(404)\ndef not_found():\n return 'Page not found', 404

D. @app.error(404)\ndef not_found(error):\n return 'Page not found', 404

Solution

1. Step 1: Recall Flask error handler syntax

   Flask uses @app.errorhandler(code) decorator to catch errors by status code.

2. Step 2: Check function signature

   The handler function must accept an error argument to receive error info.

3. Final Answer:

   @app.errorhandler(404)\ndef not_found(error):\n return 'Page not found', 404 -> Option A

4. Quick Check:

   Correct decorator and function signature = @app.errorhandler(404)\ndef not_found(error):\n return 'Page not found', 404 [OK]

Hint: Use @app.errorhandler with error param [OK]

Common Mistakes:

• Using @app.route instead of @app.errorhandler
• Missing the error parameter in handler function
• Using incorrect decorator names like @app.handle_error

3. What will be the output when accessing a missing page if this Flask code is used?

@app.errorhandler(404)
def page_not_found(error):
    return 'Oops! Page missing.', 404

@app.route('/')
def home():
    return 'Welcome!'

medium

A. Oops! Page missing.

B. 404 Not Found default Flask page

C. Internal Server Error

D. Welcome!

Solution

1. Step 1: Identify error handler for 404

   The code defines a custom 404 error handler returning 'Oops! Page missing.' with status 404.

2. Step 2: Understand request to missing page

   Accessing a missing page triggers 404, so Flask calls the custom handler instead of default page.

3. Final Answer:

   Oops! Page missing. -> Option A

4. Quick Check:

   Custom 404 handler output = 'Oops! Page missing.' [OK]

Hint: Custom 404 handler output replaces default page [OK]

Common Mistakes:

• Expecting default Flask 404 page instead of custom message
• Confusing home route output with missing page output
• Assuming server error occurs on missing page

4. Identify the error in this Flask error handler code:

@app.errorhandler(500)
def internal_error():
    return 'Server error occurred', 500

medium

A. Function name must be 'handle_500_error'.

B. Incorrect decorator name; should be @app.handle_error.

C. Return statement should not include status code.

D. Missing error parameter in the handler function.

Solution

1. Step 1: Check error handler function signature

   Flask error handlers must accept an error argument to receive error info.

2. Step 2: Verify decorator correctness

   The decorator @app.errorhandler(500) is correct; function name can be anything.

3. Final Answer:

   Missing error parameter in the handler function. -> Option D

4. Quick Check:

   Error handler needs error param = Missing error parameter in the handler function. [OK]

Hint: Error handlers need an error argument [OK]

Common Mistakes:

• Omitting the error parameter in handler function
• Using wrong decorator names
• Thinking function name is fixed

5. You want to show a custom message for both 404 and 500 errors in your Flask app. Which approach correctly handles both errors without repeating code?

hard

A. Define two separate handlers with identical code for 404 and 500 errors.

B. Use a single function and register it twice with @app.errorhandler(404) and @app.errorhandler(500).

C. Use @app.route for 404 and @app.errorhandler for 500 errors.

D. Handle errors only in the main route function with try-except blocks.

Solution

1. Step 1: Understand code reuse for error handlers

   To avoid repeating code, one function can handle multiple error codes by registering it multiple times.

2. Step 2: Check Flask syntax for multiple error handlers

   Flask allows decorating the same function multiple times with different error codes.

3. Final Answer:

   Use a single function and register it twice with @app.errorhandler(404) and @app.errorhandler(500). -> Option B

4. Quick Check:

   One function, multiple decorators = Use a single function and register it twice with @app.errorhandler(404) and @app.errorhandler(500). [OK]

Hint: Register one function with multiple @app.errorhandler decorators [OK]

Common Mistakes:

• Writing duplicate code in separate handlers
• Using @app.route for error handling
• Trying to catch errors only inside routes