Docker容器中Django应用静态文件无法加载问题求助

1. 最关键的错误：静态目录配置拼写错误 #

你在settings中写的是STATIC_FILES_DIRS，正确的变量名是STATICFILES_DIRS（无下划线）。这个拼写错误会直接导致Django无法识别你定义的静态文件目录，自然找不到CSS/JS资源。

修正后的配置片段：

STATICFILES_DIRS = [
     os.path.join(BASE_DIR, 'static'),
]

2. 验证BASE_DIR路径是否匹配 #

Django的BASE_DIR定义决定了静态文件目录的实际指向，需要确认它对应容器内的/code目录（你的Dockerfile将项目文件复制到/code，挂载卷也映射到该路径）。

进入容器执行命令验证：

docker-compose exec app python manage.py shell

在Shell中输入以下代码检查路径有效性：

import os
from django.conf import settings
print(settings.BASE_DIR)
print(os.path.exists(os.path.join(settings.BASE_DIR, 'static')))

如果第二个输出为False，说明BASE_DIR定义与静态文件实际位置不匹配。通常BASE_DIR的正确定义为：

# 若settings.py与manage.py在同一目录
BASE_DIR = os.path.dirname(os.path.abspath(__file__))
# 若settings.py在子目录（如project/settings.py）
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

3. 检查挂载卷的文件映射 #

你的docker-compose配置挂载了./app:/code，本地./app目录会覆盖容器内的/code目录，请确认：

• 本地./app目录下确实存在static文件夹
• static文件夹内包含所需的CSS/JS文件
• 文件权限已正确设置（你已设置755，此部分无需额外调整）

4. 确认DEBUG模式正常开启 #

虽然你提到已开启DEBUG，但仍需检查settings.py中的DEBUG = True。若DEBUG为False，Django自带服务器不会自动处理静态文件（生产环境需用collectstatic命令，不适用于当前场景）。

修复步骤总结 #

1. 修正STATICFILES_DIRS的拼写错误
2. 验证BASE_DIR路径与静态文件目录的匹配性
3. 确认本地./app/static目录存在且文件完整
4. 重启容器使配置生效：

   docker-compose down && docker-compose up --build
   

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