Sorl-thumbnail仅DEBUG=True时正常，DEBUG=False返回404问题求助

核心原因 #

Django内置的static()路由辅助函数默认仅在DEBUG = True时生效，这是框架的预设规则，目的是提醒开发者生产环境不要用Django本身处理静态/媒体资源，应该交由前端Web服务器（Apache2）处理。你遇到的不是Django或sorl-thumbnail的bug，属于生产环境配置遗漏。

生产环境标准解决方案（推荐） #

直接在Apache2的虚拟主机配置中添加/media路径的别名规则，让Apache直接处理媒体文件请求：

1. 打开站点Apache配置文件，通常路径为/etc/apache2/sites-available/你的站点名.conf
2. 添加如下配置，替换为你实际的项目media目录路径：

Alias /media /你的项目实际完整路径/media/
<Directory /你的项目实际完整路径/media/>
    Require all granted
</Directory>

3. 保存配置后执行systemctl reload apache2重启服务即可。

临时调试方案（禁止用于生产环境） #

如果需要临时用Django进程处理媒体文件调试，可以修改urls.py配置，手动强制添加媒体路由，不受DEBUG参数影响：

1. 先导入对应模块：

from django.urls import re_path
from django.views.static import serve
from django.conf import settings

2. 在urlpatterns列表中手动添加路由，不要和原有+ static(...)写法混用：

urlpatterns = [
    # 你原有其他路由
    re_path(r'^media/(?P<path>.*)$', serve, {'document_root': settings.MEDIA_ROOT}),
]

额外检查项 #

如果配置完上述内容仍有问题，检查以下配置：

• 确认sorl-thumbnail参数配置无异常，THUMBNAIL_MEDIA_ROOT、THUMBNAIL_MEDIA_URL默认继承MEDIA_ROOT、MEDIA_URL，如果手动修改过需要保证路径匹配
• 确认Apache运行用户（通常为www-data）对项目media目录有读写权限，否则sorl-thumbnail生成缩略图时无法写入文件会返回404
• 清理旧的缩略图缓存：执行python manage.py thumbnail clear_delete_all，删除media目录下的cache文件夹后再重启服务测试

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