File uploads handling in Flask - Performance & Optimization

Performance: File uploads handling

MEDIUM IMPACT

This affects page load speed and responsiveness during file upload processing and server response time.

Handling file uploads in a Flask web app

Flask

from flask import Flask, request
app = Flask(__name__)

@app.route('/upload', methods=['POST'])
def upload_file():
    file = request.files['file']
    with open(f'/tmp/{file.filename}', 'wb') as f:
        while chunk := file.stream.read(4096):
            f.write(chunk)  # Stream file in chunks
    return 'Upload complete'

Streaming file in chunks avoids loading entire file in memory, reducing blocking and memory use.

📈 Performance GainNon-blocking file handling; reduces memory spikes; improves INP and server responsiveness.

Handling file uploads in a Flask web app

Flask

from flask import Flask, request
app = Flask(__name__)

@app.route('/upload', methods=['POST'])
def upload_file():
    file = request.files['file']
    content = file.read()  # Reads entire file into memory
    # Process file content here
    return 'Upload complete'

Reading the entire file into memory blocks the server and uses high memory for large files.

📉 Performance CostBlocks server processing during read; high memory usage can slow response and increase INP.

Performance Comparison

Pattern	Memory Usage	Server Blocking	User Interaction Delay	Verdict
Read entire file at once	High (loads whole file in RAM)	Blocks server during read	High delay in response	[X] Bad
Stream file in chunks	Low (small buffer size)	Non-blocking or minimal blocking	Low delay, faster response	[OK] Good

Rendering Pipeline

File upload handling mainly affects server response time which impacts the browser's interaction responsiveness (INP). The browser waits for server confirmation before updating UI.

→Network

→Server Processing

→Response Rendering

⚠️ BottleneckServer Processing when reading and saving files synchronously

Core Web Vital Affected

INP

This affects page load speed and responsiveness during file upload processing and server response time.

Optimization Tips

1Avoid reading entire uploaded files into memory at once.

2Stream file uploads in small chunks to reduce server blocking.

3Monitor server response time during uploads to improve interaction speed.

Performance Quiz - 3 Questions

What is a performance risk of reading the entire uploaded file into memory at once in Flask?

A Faster file processing with no downsides

B High memory usage causing server slowdowns

C Improved user interaction speed

D Reduced network latency

DevTools: Network

How to check: Open DevTools > Network tab, upload a file, observe the POST request timing and response time.

What to look for: Look for long waiting (TTFB) or blocking times indicating server delay during file processing.

Practice

1. In Flask, which object do you use to access files uploaded by a user in a form?

easy

A. request.files

B. request.form

C. request.args

D. request.data

Solution

1. Step 1: Understand Flask request objects

   Flask provides different objects to access data sent by the client. request.files holds uploaded files.

2. Step 2: Identify correct object for file uploads

   Files sent via form with enctype='multipart/form-data' are accessed through request.files.

3. Final Answer:

   request.files -> Option A

4. Quick Check:

   File uploads = request.files [OK]

Hint: Uploaded files are in request.files, not request.form [OK]

Common Mistakes:

• Using request.form to get files
• Trying to access files via request.args
• Not using multipart/form-data in form

2. Which of the following is the correct way to check if a file was uploaded before saving it in Flask?

easy

A. if request.args.get('file')

B. if request.files['file'] is None

C. if request.form['file'] != None

D. if 'file' in request.files and request.files['file'].filename != ''

Solution

1. Step 1: Check file presence in request.files

   Use 'file' in request.files to confirm the file key exists.

2. Step 2: Ensure filename is not empty

   Check request.files['file'].filename != '' to confirm a file was selected.

3. Final Answer:

   if 'file' in request.files and request.files['file'].filename != '' -> Option D

4. Quick Check:

   Check key and filename before saving [OK]

Hint: Check both key and filename before saving file [OK]

Common Mistakes:

• Checking request.form instead of request.files
• Not verifying filename is not empty
• Using request.args for file data

3. What will be the output of this Flask route when a file named 'photo.png' is uploaded?

from flask import Flask, request
app = Flask(__name__)

@app.route('/upload', methods=['POST'])
def upload():
    f = request.files['file']
    filename = f.filename
    return f"Uploaded: {filename}"

medium

A. Uploaded: None

B. KeyError: 'file'

C. Uploaded: photo.png

D. Uploaded: ''

Solution

1. Step 1: Access file from request.files

   The code gets the file object from request.files['file'], which holds the uploaded file.

2. Step 2: Return the filename string

   The filename attribute contains the original file name, here 'photo.png', which is returned in the response.

3. Final Answer:

   Uploaded: photo.png -> Option C

4. Quick Check:

   Filename returned matches uploaded file [OK]

Hint: Filename attribute holds the uploaded file's name [OK]

Common Mistakes:

• Assuming filename is None if file exists
• Not using request.files to get file
• Forgetting to use POST method

4. Identify the error in this Flask file upload code snippet:

@app.route('/upload', methods=['POST'])
def upload():
    file = request.files['file']
    if file.filename:
        file.save('/uploads/' + file.filename)
    return 'File saved'

medium

A. Using POST method instead of GET

B. Saving file without checking if 'file' key exists in request.files

C. Missing return statement

D. Incorrect filename attribute usage

Solution

1. Step 1: Check for 'file' key in request.files

   The code accesses request.files['file'] directly without verifying if the key exists, risking a KeyError.

2. Step 2: Properly check key before accessing

   Use if 'file' in request.files before accessing to avoid errors.

3. Final Answer:

   Saving file without checking if 'file' key exists in request.files -> Option B

4. Quick Check:

   Always check key exists before accessing [OK]

Hint: Check 'file' key in request.files before accessing [OK]

Common Mistakes:

• Directly accessing request.files['file'] without check
• Assuming filename always exists
• Ignoring form enctype for file uploads

5. You want to securely save an uploaded file in Flask to a folder named 'uploads'. Which of the following is the best practice to avoid security risks?

hard

A. Use secure_filename() from werkzeug.utils before saving the file

B. Save the file directly with file.filename without changes

C. Rename the file to a fixed name like 'upload.txt' always

D. Save files outside the Flask app folder without any checks

Solution

1. Step 1: Understand filename security risks

   Using raw filenames can allow directory traversal or unsafe characters causing security issues.

2. Step 2: Use secure_filename() to sanitize filenames

   The secure_filename() function cleans the filename to a safe format before saving.

3. Final Answer:

   Use secure_filename() from werkzeug.utils before saving the file -> Option A

4. Quick Check:

   Sanitize filenames with secure_filename() [OK]

Hint: Always sanitize filenames with secure_filename() before saving [OK]

Common Mistakes:

• Saving files with user-provided names directly
• Ignoring filename sanitization
• Using fixed names causing overwrites