拆分多环境配置后Django无法显示图片的问题排查

核心问题出在你修改的BASE_DIR参数上——因为配置文件的位置从根目录下的settings.py移到了settings子目录里，BASE_DIR的计算层级出错，导致STATIC、MEDIA相关路径的基准目录偏移，最终找不到图片文件。

具体解决步骤 #

1. 修正BASE_DIR的计算方式 #

打开settings/base.py，把BASE_DIR改成符合当前文件位置的写法：

from pathlib import Path
# 因为base.py在settings子目录，需要往上跳3级才能到项目根目录（包含manage.py的目录）
BASE_DIR = Path(__file__).resolve().parent.parent.parent

或者用更直观的层级写法：

BASE_DIR = Path(__file__).resolve().ancestor(3)

验证方法：在base.py里加一行print(BASE_DIR)，启动项目后看控制台输出，确认路径是项目根目录（能看到manage.py的那个文件夹）。

2. 检查开发环境的静态/媒体文件路由 #

确保local.py里DEBUG = True，同时在项目根目录的urls.py中配置了媒体文件的路由映射：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # 你的其他业务路由
] 
# 追加静态和媒体文件的服务路由
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

3. 确认MEDIA路径配置正确性 #

检查base.py里的MEDIA相关配置，确保路径是基于正确的BASE_DIR：

MEDIA_ROOT = BASE_DIR / 'media'  # 图片实际存储的物理目录
MEDIA_URL = '/media/'  # 访问图片的URL前缀

同时确认上传的图片确实存在于MEDIA_ROOT对应的文件夹里。

4. 生产环境额外检查 #

如果是生产环境图片不显示：

• 必须运行python manage.py collectstatic命令，把所有静态文件收集到STATIC_ROOT指定的目录
• 检查Nginx等Web服务器的配置，确保/media/和/static/路径正确映射到服务器上的物理目录

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