如何让Django加载文件名包含空格的图片？

方案1：调整生产环境Web服务器配置（推荐） #

生产环境通常用Nginx或Apache直接托管/media/目录，只需修改服务器配置，让它自动将URL中的%20解码为实际空格去匹配文件：

Nginx配置 #

在/media/对应的location块中添加decode_uri on;，示例：

location /media/ {
    decode_uri on;
    alias /path/to/your/media/folder/;
    expires 30d;
}

该配置会让Nginx把URL里的%20解码成空格，从而正确找到对应文件。

Apache配置 #

在/media/的Location配置中启用AllowEncodedSlashes NoDecode，示例：

<Location /media/>
    AllowEncodedSlashes NoDecode
    Alias /media/ /path/to/your/media/folder/
</Location>

方案2：自定义Django文件存储类 #

如果无法修改Web服务器配置，可以自定义Django的存储后端，让生成的媒体URL保留原始空格（而非转成%20）：

1. 在项目中创建存储类文件，比如utils/storage.py：

from django.core.files.storage import FileSystemStorage

class UnencodedSpaceFileSystemStorage(FileSystemStorage):
    def url(self, name):
        url = super().url(name)
        # 将编码后的%20替换回原始空格
        return url.replace('%20', ' ')

2. 在settings.py中修改默认存储类：

DEFAULT_FILE_STORAGE = 'myproject.utils.storage.UnencodedSpaceFileSystemStorage'

模板中生成的src会保留原始空格，浏览器会自动处理编码，配合Web服务器的基础配置即可正常加载文件。

方案3：自定义视图手动处理媒体请求 #

如果上述方案都不适用，可以写一个自定义视图处理媒体请求，手动解码URL中的%20为空格：

1. 在views.py中添加视图：

import os
from django.http import FileResponse, Http404
from django.conf import settings

def serve_media(request, path):
    # 解码URL中的%20为实际空格
    media_path = os.path.join(settings.MEDIA_ROOT, path.replace('%20', ' '))
    if not os.path.exists(media_path) or not os.path.isfile(media_path):
        raise Http404("File not found")
    return FileResponse(open(media_path, 'rb'))

2. 在urls.py中替换原有的媒体路由：

from django.urls import path
from . import views

urlpatterns = [
    # 其他路由...
    path('media/<path:path>', views.serve_media),
]

注意：使用该方案需额外处理性能与安全问题，比如限制访问目录防止路径遍历。

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