大网数据广告活动
Web 标准与前端开发

Access-Control-Allow-Headers

· 52CE 我爱测

**`Access-Control-Allow-Headers`** 响应标头中用于响应包含了 Access-Control-Request-Headers 的preflight request,以指示在实际请求中可以使用哪些 HTTP 标头。

Access-Control-Allow-Headers 响应标头中用于响应包含了 Access-Control-Request-Headers 的preflight request,以指示在实际请求中可以使用哪些 HTTP 标头。

如果请求中包含 Access-Control-Request-Headers 标头,那么此响应标头是必需的。

[!NOTE] CORS-safelisted_request_header始终被允许,通常无需在 Access-Control-Allow-Headers 中列出(除非有必要绕过白名单的额外限制)。

<table class="properties"> <tbody> <tr> <th scope="row">标头类型</th> <td>Response header</td> </tr> <tr> <th scope="row">Forbidden header name</th> <td>否</td> </tr> </tbody> </table>

语法

Access-Control-Allow-Headers: [<header-name>[, <header-name>]*]
Access-Control-Allow-Headers: *

指令

  • <header-name>
    • : 支持的请求标头名称。此标头可以列出任意数量的请求标头,用逗号分隔。
  • *(通配符)
    • : “*”值仅在无凭证的请求(即不包含 HTTP cookie 或 HTTP 认证信息的请求)中视为特殊的通配符值。在带有凭证的请求中,它被当作字面意义的标头名称“*”处理,不具有特殊语义。请注意,在 Authorization 标头不能被泛化处理,始终需要明确列出。

示例

自定义标头

以下是一个 Access-Control-Allow-Headers 标头可能的样子。它表明服务器支持名为 X-Custom-Header 的自定义标头(除了CORS-safelisted_request_header之外)。

Access-Control-Allow-Headers: X-Custom-Header

多个标头

此示例展示了 Access-Control-Allow-Headers 如何指定支持多个标头的情况。

Access-Control-Allow-Headers: X-Custom-Header, Upgrade-Insecure-Requests

绕过额外限制

尽管CORS-safelisted_request_header始终被允许,并且通常无需在 Access-Control-Allow-Headers 中列出,但无论如何列出它们都将绕过适用的额外限制。

Access-Control-Allow-Headers: Accept

预检请求示例

让我们来看一个涉及 Access-Control-Allow-Headers 的preflight request的示例。

请求

首先看请求。预检请求是一个使用 OPTIONS 方法的请求,它包含预检请求头中的三个部分的某些组合:Access-Control-Request-Method、Access-Control-Request-Headers 和 Origin。

下面的预检请求告知服务器,我们想要发送一个 CORS GET 请求,并且该请求携带着 Access-Control-Request-Headers 中列出的标头(即 Content-Type 和 x-requested-with)。

OPTIONS /resource/foo
Access-Control-Request-Method: GET
Access-Control-Request-Headers: Content-Type, x-requested-with
Origin: https://foo.bar.org

响应

如果由预检请求指示的 CORS 请求被授权,服务器将使用一个消息响应预检请求,该消息表明允许的源、方法和标头。如下所示,Access-Control-Allow-Headers 包含了所请求的标头信息。

HTTP/1.1 200 OK
Content-Length: 0
Connection: keep-alive
Access-Control-Allow-Origin: https://foo.bar.org
Access-Control-Allow-Methods: POST, GET, OPTIONS, DELETE
Access-Control-Allow-Headers: Content-Type, x-requested-with
Access-Control-Max-Age: 86400

如果请求的方法不被支持,服务器将响应一个错误。

规范

浏览器兼容性

参见

  • Access-Control-Allow-Origin
  • Access-Control-Expose-Headers
  • Access-Control-Allow-Methods
  • Access-Control-Request-Headers

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。