现象:axios 调 Django 接口报 403
前端 ReaCt 用 axios 调 Django REST Framework 后端,GET 请求正常,POST/PUT/DELETE 直接 403。Chrome DevTools 网络面板里看到先发了 OPTIONS 预检请求,Django 没返回正确的 Access-Control-Allow-* 头,浏览器就把后续的 POST 挡掉了。
根因:Django 默认不处理 CORS 预检
跨域 POST 请求浏览器会先发 OPTIONS 预检,检查服务端是否允许跨域。Django 默认不处理 OPTIONS 请求,直接返回 403。需要装 django-cors-headers 中间件来处理。
# 安装 django-cors-headers
pip install django-cors-headers
# settings.py 里配置
INSTALLED_APPS = [
'corsheaders', # 放在最前面
'rest_framework',
...
]
MIDDLEWARE = [
'corsheaders.middleware.CorsMiddleware', # 放在中间件最前面
'django.middleware.security.SecurityMiddleware',
...
]
# 允许所有源(开发用)
CORS_ALLOW_ALL_ORIGINS = True
# 生产环境配置具体域名
CORS_ALLOWED_ORIGINS = [
"http://localhost:3000",
"https://www.example.com",
]
特殊场景:带 Cookie 的跨域
如果需要跨域携带 Cookie(比如认证场景),还要加两个配置:
CORS_ALLOW_CREDENTIALS = True
# 注意:ALLOWED_ORIGINS 不能用 * 了,必须具体域名
CORS_ALLOWED_ORIGINS = [
"https://www.example.com",
]
# 前端 axios 也要加
axios.defaults.withCredentials = true
预检请求缓存时间
每次跨域 POST 都发 OPTIONS 预检有点慢,可以让浏览器缓存预检结果。django-cors-headers 支持配置:
# 浏览器缓存预检结果 86400 秒(24小时)
# 减少 OPTIONS 请求次数
CORS_PREFLIGHT_MAX_AGE = 86400
总结:axios 跨域调 Django 报 403,先装 django-cors-headers 中间件处理 OPTIONS 预检。开发环境设 CORS_ALLOW_ALL_ORIGINS=True,生产环境配具体域名。带 Cookie 还要开 CORS_ALLOW_CREDENTIALS。
