axios 调 Django 后端接口报 403 CORS 错误 Access-Control-Allow-Origin 和 Preflight 预检怎么配

现象: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。

您可以还会对下面的文章感兴趣: