Performance Caching with Flask-Caching0%
Testing Flask with Pytest, Gunicorn & Docker Deployment

Performance Caching with Flask-Caching

Beginner12 min read•Updated: Jul 11, 2026
Study MaterialsCheatsheet

Performance Caching with Flask-Caching

Serving high-traffic web applications requires minimizing redundant database queries and expensive computations. If 10,000 users request your course catalog homepage every minute, running the exact same SQL queries 10,000 times wastes database CPU and degrades response times.

Flask-Caching is the standard extension for caching view responses, database query results, and arbitrary Python functions using in-memory caches or Redis.

1. Installing and Configuring Flask-Caching

Bash / Terminal
pip install Flask-Caching redis

In app.py:

Python
from flask import Flask
from flask_caching import Cache
 
app = Flask(__name__)
 
# Configure Redis cache backend
app.config["CACHE_TYPE"] = "RedisCache"
app.config["CACHE_REDIS_URL"] = "redis://localhost:6379/1"
app.config["CACHE_DEFAULT_TIMEOUT"] = 300 # Default cache expiry: 5 minutes
 
# Initialize extension
cache = Cache(app)

Cache Backends Comparison:

  • SimpleCache: Local Python dictionary memory cache (single-process development only).
  • RedisCache: Production-grade distributed in-memory cache shared across multiple Gunicorn workers.
  • MemcachedCache: High-throughput key-value memory cache.
  • NullCache: Disables caching entirely (useful for testing).

2. Caching Entire View Responses (@cache.cached)

To cache the full HTML or JSON output of a route:

Python
@app.route("/api/v1/stats")
@cache.cached(timeout=60) # Cached for 60 seconds
def get_global_statistics():
# Simulated heavy aggregation query across millions of rows
stats = {
"total_students": Student.query.count(),
"total_courses": Course.query.count(),
"active_enrollments": 14250
}
return jsonify(stats)

The first request executes the database query and stores the output in Redis. All subsequent requests for the next 60 seconds return directly from Redis in under 3 milliseconds!

3. Query Parameter-Aware Caching (query_string=True)

If your endpoint accepts query parameters (like pagination or search filters), you must set query_string=True so different query strings create distinct cache keys:

Python
@app.route("/courses")
@cache.cached(timeout=120, query_string=True)
def list_courses():
# /courses?page=1 and /courses?page=2 get cached separately!
page = request.args.get("page", 1, type=int)
courses = Course.query.paginate(page=page, per_page=12)
return render_template("courses.html", courses=courses)

4. Caching Expensive Functions (@cache.memoize)

When you want to cache the output of a specific internal function based on its input arguments:

Python
@cache.memoize(timeout=3600)
def calculate_user_analytics(user_id):
print(f"Executing complex calculation for User {user_id}...")
# Heavy aggregation logic
return {"user_id": user_id, "score": 98.4}

5. Cache Invalidation (cache.delete / cache.delete_memoized)

When underlying database records change, stale cache entries must be evicted immediately:

Python
@app.route("/api/v1/courses/new", methods=["POST"])
def create_course():
# ... persist new course to database ...
# Invalidate cached view so users see the new course immediately!
cache.delete_memoized(list_courses)
cache.delete("view//courses")
return {"status": "Created"}, 201
Interactive Quiz

Practice Quiz

Question 1
What happens on the second request to an endpoint decorated with @cache.cached(timeout=60)?
Question 2
Why is query_string=True mandatory when caching endpoints with pagination or search filters?
Question 3
What is the primary difference between @cache.cached and @cache.memoize?
Question 4
Which cache backend should be used for production deployments running multiple Gunicorn workers?
Question 5
What does "cache invalidation" mean in web application architecture?
Next Lesson

Testing Flask with Pytest, Gunicorn & Docker Deployment

Continue learning with hands-on practice, examples, and exercises in the upcoming topic.

Related Lessons

Previous LessonNext Lesson
Background Tasks with Celery and RedisTesting Flask with Pytest, Gunicorn & Docker Deployment

Practice Quiz

Test your understanding of this lesson with 5 questions. Each question has one correct answer.

PreviousNext
PrevNext