Django+Python校园日志系统404错误：路径/api/未匹配路由

后端404问题 #

原因 #

根路径/未配置对应的路由映射，当前所有业务路由都挂载在api/前缀下（如api/journal/），访问根目录自然找不到匹配的路径。

修复方案 #

两种可选方案：

1. 根路径重定向：在项目根urls.py中给/配置重定向，比如跳转到admin后台或API文档：

from django.urls import path, include
from django.shortcuts import redirect
from django.contrib import admin

urlpatterns = [
    path('', lambda request: redirect('admin/')),  # 重定向到admin
    path('admin/', admin.site.urls),
    path('api/user/', include('user.urls')),
    path('api/event/', include('event.urls')),
    path('api/timetable/', include('timetable.urls')),
    path('api/journal/', include('journal.urls')),
]

2. 根路径显示API文档：如果希望根路径展示API列表，可添加DRF的自动文档页面：

from django.urls import path, include
from django.contrib import admin
from rest_framework.documentation import include_docs_urls

urlpatterns = [
    path('', include_docs_urls(title='校园日志系统API')),  # 根路径展示API文档
    path('admin/', admin.site.urls),
    path('api/user/', include('user.urls')),
    path('api/event/', include('event.urls')),
    path('api/timetable/', include('timetable.urls')),
    path('api/journal/', include('journal.urls')),
]

前端页面空白问题 #

排查与修复步骤 #

1. 检查浏览器控制台：按F12打开开发者工具，查看Console标签页的JS报错，以及Network标签页的请求失败记录，定位具体问题。
2. 验证API地址配置：确认前端代码中API请求的baseURL是否正确指向http://127.0.0.1:8000/api/，避免地址错误或跨域问题。
3. 配置跨域支持：若前端运行在不同端口（如3000），后端需配置CORS：
   • 安装依赖：pip install django-cors-headers
   • 在项目settings.py中添加配置：

     INSTALLED_APPS = [
         # ... 其他应用
         'corsheaders',
     ]
     
     MIDDLEWARE = [
         'corsheaders.middleware.CorsMiddleware',
         'django.middleware.common.CommonMiddleware',
         # ... 其他中间件
     ]
     
     CORS_ALLOWED_ORIGINS = [
         "http://localhost:3000",
         "http://127.0.0.1:3000",
     ]
     

4. 检查React组件渲染：确认入口组件（如App.js）是否存在条件渲染导致的空白（例如未登录时直接返回null），排查组件逻辑是否正常执行。

内容的提问来源于stack exchange，提问作者Кирилл Кулик