Django设置静态文件目录时触发AttributeError: 'WindowsPath' object has no attribute 'rpartition'错误求助

Hey there! Let's break down what's going on and fix this issue step by step.

1. Understand the Root Cause #

The AttributeError: 'WindowsPath' object has no attribute 'rpartition' happens because older versions of Django (pre-3.1) don't support using Path objects directly for STATIC_ROOT. When you use BASE_DIR / "staticfiles", you're creating a WindowsPath object, but Django's internal code expects a string path and tries to call string-specific methods like rpartition() on it.

2. Fix the STATIC_ROOT Configuration #

The simplest fix is to convert the Path object to a string. Update your settings.py line to:

STATIC_ROOT = str(BASE_DIR / "staticfiles")

If you're using Django 3.1 or newer, you can stick with the Path object, but if you're on an older version (which is likely causing this error), converting to a string will resolve the rpartition issue.

3. Stop Using STATICDIR (It's Not a Valid Django Setting) #

You mentioned trying STATICDIR instead—this isn't a recognized Django setting for static files. The correct settings related to static files are:

• STATIC_ROOT: The directory where collectstatic will gather all static files.
• STATIC_URL: The URL path to access static files (e.g., /static/).
• STATICFILES_DIRS: A list of additional directories where Django should look for static files (beyond the static folders in your apps).

So forget STATICDIR and stick to the official settings.

4. Correct the Template Folder Configuration (Bonus Fix) #

You also mentioned adding your template folder to INSTALLED_APPS—this is unnecessary and might cause template loading issues later. Instead, configure your templates in the TEMPLATES section of settings.py:

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        # Add your templates directory here
        'DIRS': [BASE_DIR / 'templates'],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

This tells Django where to find your project-level templates without needing to add the folder to INSTALLED_APPS.

5. Test the Fix #

After updating these settings, run python manage.py collectstatic to verify the static files are collected correctly without errors. If you're running the development server, restart it to apply the changes.

内容的提问来源于stack exchange，提问作者naskoto