为何django.conf.urls.static.static返回空列表？

以下是几个常见原因及对应解决办法：

1. DEBUG 模式未启用 #

Django 的 django.conf.urls.static.static() 方法仅在 DEBUG=True 时才会生成有效URL模式，哪怕你自定义了LOCALHOST_DEVELOPMENT开关，该方法内部依然依赖DEBUG配置。

排查：
在Django Shell中执行：

>>> from django.conf import settings
>>> print(settings.DEBUG)

若输出为False，即为问题根源。

解决：

• 本地开发环境将settings.DEBUG设置为True；
• 若需保留自定义的LOCALHOST_DEVELOPMENT判断，可手动构造Media URL路由替代static()方法：

  from django.urls import re_path
  from django.views.static import serve
  
  if settings.LOCALHOST_DEVELOPMENT:
      urlpatterns += [
          re_path(r'^media/(?P<path>.*)$', serve, {'document_root': settings.MEDIA_ROOT}),
      ]
  

2. MEDIA_ROOT 不是绝对路径 #

static()方法会校验MEDIA_ROOT是否为合法绝对路径，若使用相对路径（如'media'），会导致方法返回空列表。

排查：
执行以下命令确认路径类型：

>>> from django.conf import settings
>>> import os
>>> print(os.path.isabs(settings.MEDIA_ROOT))

输出False则说明是相对路径问题。

解决：
用项目根目录拼接绝对路径，示例：

# settings.py
# 方式1：os模块
import os
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

# 方式2：pathlib（Django 3.0+推荐）
from pathlib import Path
BASE_DIR = Path(__file__).resolve().parent.parent
MEDIA_ROOT = BASE_DIR / 'media'

3. MEDIA_URL 格式不符合要求 #

需确保MEDIA_URL是以斜杠开头且结尾的路径（如'/media/'），拼写错误、多余空格或格式缺失都会导致static()方法失效。

排查：

>>> from django.conf import settings
>>> print(settings.MEDIA_URL)

确认输出严格为'/media/'，无其他冗余字符。

4. 错误导入static方法 #

确保导入的是路由生成用的static，而非模板标签中的同名函数：

# 正确导入
from django.conf.urls.static import static

# 错误导入（仅用于模板生成静态URL）
from django.templatetags.static import static

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