You need to enable JavaScript to run this app. 为什么axios向Django REST Framework发POST请求会触发CORS报错?
优惠活动
大模型
产品
解决方案
定价
更多

为什么axios向Django REST Framework发POST请求会触发CORS报错?

跨域POST请求失效的排查与修复方案

核心问题定位

你遇到的「GET请求正常、POST跨域报CORS错误、命令行/DRF自带接口可正常提交」的特征,是典型的CORS预检请求(OPTIONS)处理失效导致的,和Flask迁移期的配置差异、前端请求头错误设置直接相关。
这个问题本质是Flask-CORS库默认自动完成的两件事,在Django生态里需要手动配置:一是自动处理所有跨域OPTIONS预检请求,二是绕过对跨域POST的默认CSRF校验,迁移时如果遗漏这两项配置,就会出现GET正常、POST跨域报错的特征。


1. 修正django-cors-headers的中间件顺序

这是最高概率的触发原因:

  • 错误点:当前配置里corsheaders.middleware.CorsMiddleware的位置必须处于MIDDLEWARE列表的最顶端(SecurityMiddleware之后的第一位),必须早于CommonMiddleware、CsrfViewMiddleware。如果你的配置里CorsMiddleware前面还有其他自定义/内置中间件,会导致OPTIONS预检请求被后续中间件提前拦截,根本走不到CORS的放行逻辑。
  • 正确配置示例:
MIDDLEWARE = [
    'corsheaders.middleware.CorsMiddleware', # 必须放在第一位(除SecurityMiddleware外)
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    # 其余中间件按原有顺序排列即可
]

2. 关闭对跨域POST的CSRF校验拦截

Django默认开启的CSRF防护,会对所有非GET/HEAD/OPTIONS的跨域请求强制校验Token,就算CORS配置完全正确,CSRF拦截返回的403响应没有带正确的CORS头,浏览器依然会抛出CORS错误:

  • 临时验证方式:在对应视图上加@csrf_exempt装饰器,确认是否能正常通信:
from django.views.decorators.csrf import csrf_exempt
from django.utils.decorators import method_decorator

@method_decorator(csrf_exempt, name='dispatch')
class SnippetView(ListCreateView):
    queryset = Snippet.objects.all()
    serializer_class = SnippetSerializer
  • 生产环境配置:如果不需要基于Session的身份校验,可以直接在DRF配置里把SessionAuth从默认认证类里移除,避免CSRF校验触发:
# settings.py
REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': [
        'rest_framework.authentication.TokenAuthentication', # 按需替换为你的业务认证方式
    ]
}

3. 清理前端axios的错误请求头配置

你之前手动设置的请求头存在两个硬错误,直接触发预检失败:

  • 错误点1:Access-Control-Allow-Origin是服务端返回的响应头,前端请求携带这个头没有任何作用,反而会被浏览器当成自定义请求头,触发额外的预检规则校验。
  • 错误点2:同一个请求头配置里重复写了两次Content-Type,后者会覆盖前者,导致实际请求的内容格式变成application/x-www-form-urlencoded,和DRF期望的JSON格式不匹配。
  • 正确的axios请求示例:
let snippet = { code: 'abc', text: ''}
axios.post('http://localhost:8000/data/snippets', snippet, {
  headers: {
    'Content-Type': 'application/json'
  }
})
.then(res => console.log(res.data))

4. 补全django-cors-headers的必要配置

仅设置CORS_ORIGIN_ALLOW_ALL = True不足以覆盖所有跨域场景,需要补充预检请求的允许规则:

# settings.py
from corsheaders.defaults import default_headers

CORS_ORIGIN_ALLOW_ALL = True
# 允许所有非简单请求的常见头通过预检
CORS_ALLOW_HEADERS = list(default_headers) + [
    'content-type',
    'authorization'
]
# 允许预检请求通过所有常用HTTP方法
CORS_ALLOW_METHODS = [
    'DELETE', 'GET', 'OPTIONS', 'PATCH', 'POST', 'PUT'
]

验证方式

修复后打开浏览器开发者工具的「网络」面板,找到对应POST请求的「预检请求(OPTIONS)」条目,确认:

  • 预检请求的响应状态码为200
  • 响应头包含Access-Control-Allow-Origin: *
  • 真实POST请求不再被拦截,正常到达后端服务。

内容的提问来源于stack exchange,提问作者barryjs

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 14:36:03