为什么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
相关产品推荐
相关产品推荐

