Python Flask - Redirect and Errors

Introduction to Flask Redirect and Error Handling

When building web applications using Flask, it's important to control the user flow and provide meaningful feedback when something goes wrong. Flask makes it simple to redirect users to different pages and handle common HTTP errors like 404 (Page Not Found) and 500 (Internal Server Error).

Using Redirects in Flask

Flask provides a built-in function called redirect() that allows you to send users to a different endpoint or external URL. This is useful after successful login, form submission, or access control logic.

from flask import Flask, redirect, url_for

app = Flask(__name__)

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

@app.route('/login')
def login():
    return 'Login Page'

@app.route('/success')
def success():
    return redirect(url_for('login'))

In this example, visiting /success will redirect the user to the /login route using Flask’s url_for() to dynamically resolve the route.

Redirecting to External URLs

Besides internal routes, you can also redirect users to third-party websites or external URLs by passing a full web address:

@app.route('/go-google')
def go_google():
    return redirect('https://www.google.com')

Handling Errors in Flask

Web apps often run into issues like missing pages or server crashes. Flask allows you to customize how your application handles such errors by using error handlers.

Creating a Custom 404 Error Page

To display a friendly message when a user accesses a non-existent route, define a handler for the 404 error:

@app.errorhandler(404)
def page_not_found(e):
    return 'Oops! Page not found.', 404

Handling Internal Server Errors (500)

You can also catch server-side errors using the 500 error handler:

@app.errorhandler(500)
def internal_error(e):
    return 'An internal error occurred.', 500

These custom error pages improve user experience and give you better control over how your app behaves during failures.

Combining Redirects with Error Handling

A common use case is redirecting users when they hit an error or try to access unauthorized content. For example:

@app.route('/admin')
def admin():
    # Simulating an error or unauthorized access
    return redirect(url_for('login'))

This route simulates checking for user permissions and redirects to the login page if needed.

Summary

In Flask, redirecting and handling errors are essential techniques for managing user experience and application behavior. The redirect() function and error handlers like @app.errorhandler() give you full control over navigation and graceful failure responses in your web application.