讲师中心 微信公众号
AI工具推荐 视频效率加速

Python前后端分离怎么解决CORS跨域报错_Django配置corsheaders中间件放行源

夜浩吖_2758

夜浩吖_2758

发布时间:2026-04-21 20:45:29

|

1008人浏览过

|

来源于php中文网

原创

加 CORS 头仍 403 或预检失败,主因是中间件顺序错误(CorsMiddleware 必须在 CommonMiddleware 之前)、CORS_ALLOW_HEADERS 未包含 authorization 等非简单头、生产环境误用 CORS_ALLOW_ALL_ORIGINS、Nginx 未透传 CORS 响应头或缓存/缓冲区配置不当。

python前后端分离怎么解决cors跨域报错_django配置corsheaders中间件放行源

为什么加了 corsheaders 还是 403 或预检失败?

常见现象是:前端发 POST 或带自定义 header 的请求时,浏览器先发 OPTIONS 预检,Django 返回 403 —— 这往往不是没装中间件,而是中间件顺序或配置漏项。

关键点:corsheaders 必须在 django.middleware.common.CommonMiddleware 之前,否则 OPTIONS 请求会被后者拦截并返回空响应(无 CORS 头),导致预检失败。

  • 检查 MIDDLEWARE 列表,确保 'corsheaders.middleware.CorsMiddleware' 在 'django.middleware.common.CommonMiddleware' 上方
  • 确认 INSTALLED_APPS 中已注册 'corsheaders'
  • CORS_ALLOW_ALL_ORIGINS = True 仅适用于开发;生产环境必须用 CORS_ALLOWED_ORIGINS 显式声明(如 ['http://localhost:3000', 'https://myapp.com'])
  • 如果前端带 cookie,需同时设 CORS_ALLOW_CREDENTIALS = True,且 CORS_ALLOWED_ORIGINS 不能为 ['*'](浏览器强制拒绝)

如何让 Django 放行带 Authorization 或 Content-Type: application/json 的请求?

默认情况下,corsheaders 不自动放行非简单 header(如 Authorization)或非简单 Content-Type(如 application/json),会触发预检,但若未显式允许,预检响应中缺失 Access-Control-Allow-Headers,前端报错“Request header field Authorization is not allowed by Access-Control-Allow-Headers”。

  • 添加 CORS_ALLOW_HEADERS = ['*'](开发可接受)或精确列出:['content-type', 'authorization', 'x-csrftoken']
  • 若用 JWT,在前端请求头写 Authorization: Bearer xxx,后端必须把 authorization 加入 CORS_ALLOW_HEADERS
  • CORS_EXPOSE_HEADERS 仅控制哪些响应头能被前端 JS 读取(如 X-Total-Count),和跨域放行无关,别混淆

Django REST Framework + corsheaders 组合下,CSRF 和 CORS 怎么共存?

前后端分离时,前端通常不走 Django 模板,CSRF 保护默认失效;但若仍需 CSRF(比如部分接口要求 session 登录),就会和 CORS 冲突:浏览器因缺少 SameSite 或 credentials 配置拒绝发送 cookie,导致 CSRF 验证失败。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限

下载

立即学习“Python免费学习笔记(深入)”;

  • 前端 axios/fetch 发请求时必须设 withCredentials: true(或 credentials: 'include')
  • Django 端需配 CORS_ALLOW_CREDENTIALS = True,且 CORS_ALLOWED_ORIGINS 不能含通配符
  • 确保 SESSION_COOKIE_SAMESITE = 'Lax'(或 'None' + SESSION_COOKIE_SECURE = True,仅限 HTTPS)
  • DRF 的 SessionAuthentication 依赖 cookie,若只用 TokenAuthentication,则无需处理 CSRF,CORS_ALLOW_CREDENTIALS 可设为 False

生产环境部署 Nginx 后,CORS 头突然消失?

常见于 Nginx 反向代理 Django 时,Nginx 默认不透传响应头,尤其 Access-Control-Allow-Origin 这类自定义头会被过滤掉,浏览器收不到,仍报跨域。

  • Nginx 配置里加 add_header 'Access-Control-Allow-Origin' '$http_origin' always;(注意 always,否则 4xx/5xx 响应不生效)
  • 同时透传其他 CORS 头:add_header 'Access-Control-Allow-Credentials' 'true' always;、add_header 'Access-Control-Allow-Headers' '$http_access_control_request_headers' always;
  • 更稳妥的做法是:关掉 Nginx 的 CORS 头,确保所有 CORS 逻辑由 Django corsheaders 控制,Nginx 只做代理,不干预响应头

真正容易被忽略的是预检缓存时间(Access-Control-Max-Age)和 header 大小限制——Nginx 默认 large_client_header_buffers 较小,遇到长 origin 或多 header 的 OPTIONS 请求可能直接 400。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2643

2023.08.11

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6730

2024.03.19

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

6166

2024.03.19

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1811

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

4764

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1769

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

28377

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3407

2023.08.04

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

40

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn