Python后端项目中React静态文件无法加载的问题求助

问题场景 #

后端基于Django（Python）开发，前端使用ReactJS，执行python manage.py runserver后项目能正常启动，但前端静态文件（CSS、JS等）无法被找到。

错误配置分析 #

现有配置存在两个关键问题：

• STATICFILES_DIRS路径错误：os.path.join(BASE_DIR, '/clientApp/build/static')中，路径开头的/会让os.path.join忽略前面的BASE_DIR，生成绝对路径/clientApp/build/static，而非项目根目录下的对应路径。
• Path与os.path混用：BASE_DIR是Path对象，却用os.path.join拼接路径，容易出现路径格式不一致问题。

修正后的配置 #

settings.py 修正 #

import os
from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

# 用Path拼接确保路径正确性
STATICFILES_DIRS = [
    BASE_DIR / "clientApp" / "build" / "static",
]
STATIC_ROOT = BASE_DIR / "static"

STATIC_URL = '/static/'

urls.py 优化 #

开发环境下（DEBUG=True），Django会自动处理STATICFILES_DIRS中的静态文件，无需额外添加static()配置，可简化为：

urlpatterns = [
    path('', index, name='index'),
]

如果坚持保留static()配置，需确保document_root指向正确的静态文件目录，但开发环境更推荐依赖Django的自动处理逻辑。

验证步骤 #

1. 先在React项目目录下执行npm run build，生成clientApp/build目录。
2. 重启Django开发服务器：python manage.py runserver。
3. 访问项目页面，检查静态文件是否正常加载。

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