Nginx 跨域配置中怎么配置 Access-Control-Allow-Methods 允许前端发起 PUT 和 DELETE 请求

舞夢輝影

舞夢輝影

2026-07-30

574人浏览

原创

nginx需在options预检响应中设置紧凑格式的access-control-allow-methods: get,post,put,delete,options,并用if判断拦截options请求返回204,同时主请求响应也须携带access-control-allow-origin和access-control-allow-credentials。

nginx 跨域配置中怎么配置 access-control-allow-methods 允许前端发起 put 和 delete 请求

要让前端跨域发起 PUTDELETE 请求,Nginx 必须在 预检响应(OPTIONS) 中正确设置 Access-Control-Allow-Methods,且该头必须明确包含 PUT,DELETE,同时配合其他 CORS 头协同生效。


明确声明允许的 HTTP 方法

Access-Control-Allow-Methods 是浏览器预检阶段校验的关键响应头。它必须是一个逗号分隔、不含空格的字符串(如 GET,POST,PUT,DELETE,OPTIONS),且值需与后端实际支持的方法严格一致。

常见错误写法:
GET, POST, PUT, DELETE(含空格,部分旧浏览器会解析失败)
GET,POST,PUT,DELETE,OPTIONS(紧凑格式更稳妥)

配置示例:

add_header 'Access-Control-Allow-Methods' 'GET,POST,PUT,DELETE,OPTIONS' always;

必须配合 OPTIONS 请求的特殊处理

仅靠 add_header 不够——因为 OPTIONS 请求不能转发给后端(否则可能 405 或 502),必须由 Nginx 立即响应 204,并在响应中带上完整 CORS 头。

推荐写法(放在对应 location 块内):

if ($request_method = 'OPTIONS') {
    add_header 'Access-Control-Allow-Origin' 'https://your-frontend.com';
    add_header 'Access-Control-Allow-Methods' 'GET,POST,PUT,DELETE,OPTIONS';
    add_header 'Access-Control-Allow-Headers' 'Content-Type,Authorization,X-Requested-With';
    add_header 'Access-Control-Allow-Credentials' 'true';
    add_header 'Access-Control-Max-Age' 1728000;
    add_header 'Content-Length' 0;
    add_header 'Content-Type' 'text/plain; charset=utf-8';
    return 204;
}

⚠️ 注意:Access-Control-Allow-Origin 若设为 *,则 Access-Control-Allow-Credentials 必须为 false;若前端带 cookie(withCredentials: true),这里必须写具体域名,不能用 *

面向设计的AXUI前端框架表单
面向设计的AXUI前端框架表单

面向设计的AXUI前端框架表单是一款包含表格、列表、弹窗等的AXUI前端框架表单下载。

下载

确保主请求也携带对应头(非预检阶段)

除 OPTIONS 外,正常 PUT/DELETE 请求的响应中,仍需返回 Access-Control-Allow-OriginAccess-Control-Allow-Credentials(如有需要),否则浏览器可能拒绝读取响应体。

可在同一 location 块中统一添加:

add_header 'Access-Control-Allow-Origin' 'https://your-frontend.com' always;
add_header 'Access-Control-Allow-Credentials' 'true' always;

always 参数确保即使返回 4xx/5xx 状态码也携带该头(避免被忽略)。


验证是否生效

前端发起 fetch('/api/user/123', { method: 'PUT', credentials: 'include' }) 后:

  • 浏览器先发 OPTIONS 请求 → 查看响应头是否含 Access-Control-Allow-Methods: GET,POST,PUT,DELETE,OPTIONS
  • 再发真实 PUT 请求 → 查看响应头是否含 Access-Control-Allow-OriginAccess-Control-Allow-Credentials

可用 curl 模拟预检:

curl -H "Origin: https://your-frontend.com" \
     -H "Access-Control-Request-Method: PUT" \
     -H "Access-Control-Request-Headers: Content-Type,Authorization" \
     -X OPTIONS -I http://your-nginx-domain/api/user/123

响应中应包含全部所需 CORS 头,状态码为 204

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关专题

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

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

2023.08.11

1062

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

2187

6

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

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

2024.03.19

2080

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

2229

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

333

5

nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

339

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

1683

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

2075

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

413

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习