Fix 404 Not Found: GET /static/css/styles.css HTTP/1.1 404 Not Found in Django

This error means Django cannot serve the requested static file because it is not collected or the static files configuration is incorrect. Fix it by running collectstatic, verifying STATIC_URL and STATIC_ROOT in settings, ensuring the file exists in the correct app's static/ directory, and using {% static %} template tags.

Reading the Stack Trace

Here's what each line means:

• File "/venv/lib/python3.11/site-packages/django/contrib/staticfiles/views.py", line 36, in serve: Django's static file server is looking for the file in the STATIC_ROOT directory.
• File "/venv/lib/python3.11/site-packages/django/views/static.py", line 44, in serve: The file was not found at the expected path. It either was not collected or does not exist.
• raise Http404('"%(path)s" does not exist': Django returns a 404 because the static file is missing from the collected static files directory.

Common Causes

# settings.py
STATIC_URL = '/static/'
STATIC_ROOT = BASE_DIR / 'staticfiles'
# Never ran: python manage.py collectstatic

# File at: myapp/styles.css  (WRONG)
# Should be: myapp/static/myapp/styles.css

# template.html
<link rel="stylesheet" href="{% static 'myapp/styles.css' %}">

<!-- template.html -->
<link rel="stylesheet" href="/static/css/styles.css">
<!-- Breaks when STATIC_URL is changed to a CDN URL -->

The Fix

Use the {% static %} template tag instead of hardcoding URLs. Configure STATICFILES_DIRS to include your project-level static directory, set STATIC_ROOT for collectstatic output, and run collectstatic before deploying.

<!-- template.html -->
<link rel="stylesheet" href="/static/css/styles.css">
<script src="/static/js/app.js"></script>

<!-- template.html -->
{% load static %}
<link rel="stylesheet" href="{% static 'css/styles.css' %}">
<script src="{% static 'js/app.js' %}"></script>

# settings.py
STATIC_URL = '/static/'
STATIC_ROOT = BASE_DIR / 'staticfiles'
STATICFILES_DIRS = [
    BASE_DIR / 'static',
]

# Run collectstatic:
# python manage.py collectstatic --noinput

Testing the Fix

import pytest
from django.test import TestCase, Client
from django.contrib.staticfiles import finders


class TestStaticFiles(TestCase):
    def test_css_file_exists(self):
        result = finders.find('css/styles.css')
        assert result is not None, 'css/styles.css not found by static finders'

    def test_js_file_exists(self):
        result = finders.find('js/app.js')
        assert result is not None, 'js/app.js not found by static finders'

    def test_template_uses_static_tag(self):
        client = Client()
        response = client.get('/')
        assert response.status_code == 200
        content = response.content.decode()
        assert '/static/css/styles.css' in content or 'styles.css' in content

    def test_static_file_is_served(self):
        client = Client()
        response = client.get('/static/css/styles.css')
        assert response.status_code == 200

Run your tests:

pytest

Pushing Through CI/CD

git checkout -b fix/static-files-not-found,git add templates/ settings.py static/,git commit -m "fix: use static template tag and configure staticfiles correctly",git push origin fix/static-files-not-found

Your CI config should look something like this:

name: CI
on:
  pull_request:
    branches: [main]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'
          cache: 'pip'
      - run: pip install -r requirements.txt
      - run: python manage.py collectstatic --noinput
      - run: pytest --tb=short -q

The Full Manual Process: 18 Steps

Here's every step you just went through to fix this one bug:

1. Notice the error alert or see it in your monitoring tool
2. Open the error dashboard and read the stack trace
3. Identify the file and line number from the stack trace
4. Open your IDE and navigate to the file
5. Read the surrounding code to understand context
6. Reproduce the error locally
7. Identify the root cause
8. Write the fix
9. Run the test suite locally
10. Fix any failing tests
11. Write new tests covering the edge case
12. Run the full test suite again
13. Create a new git branch
14. Commit and push your changes
15. Open a pull request
16. Wait for code review
17. Merge and deploy to production
18. Monitor production to confirm the error is resolved

Total time: 30-60 minutes. For one bug.

pip install bugstack

import bugstack

bugstack.init(api_key=os.environ["BUGSTACK_API_KEY"])

Deploying the Fix (Manual Path)

1. Run collectstatic locally and verify all files are present.
2. Open a pull request with the template and settings fixes.
3. Wait for CI checks including collectstatic to pass.
4. Have a teammate review and approve the PR.
5. Merge to main and verify static files load correctly in staging.

Frequently Asked Questions