预检阶段报 'Method PUT is not allowed' 的原因和服务器配置,模拟器逐步演示。
场景预设
请求 — 浏览器(页面)侧
Method
Content-Type
自定义头部
Access-Control-Request-Headers: content-type
响应 — 服务器返回的头部
Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
请求所需 + 常用头部 — 点击切换
浏览器处理步骤
页面发起 fetch 请求
非简单请求 — 需要 OPTIONS 预检
发送 OPTIONS 预检请求
OPTIONS /data HTTP/1.1 Origin: https://myapp.example.com Access-Control-Request-Method: PUT Access-Control-Request-Headers: content-type
服务器预检响应到达
HTTP/1.1 204 No Content Access-Control-Allow-Origin: https://myapp.example.com Access-Control-Allow-Methods: GET, POST Access-Control-Allow-Headers: content-type
Allow-Origin 与来源一致 — 通过
请求方法不在 Allow-Methods 中PUT
请求头部全部在 Allow-Headers 中 — 通过
未携带凭据 — 跳过检查
浏览器拦截响应并 reject fetch
浏览器控制台
✕ Access to fetch at 'https://api.example.com/data' from origin 'https://myapp.example.com' has been blocked by CORS policy: Method content-type is not allowed by Access-Control-Allow-Methods in preflight response.
(index):1
修改任意值,下方步骤会立即重新计算。试试「credentials + *」场景看通配符为何被拦。
用了 PUT/DELETE/PATCH 就需要预检,Allow-Methods 不含该方法时浏览器以 'Method X is not allowed' 拦截——正式请求根本没发出,尽管端点存在。
常见错误:Allow-Methods 只列 GET/POST;服务器或反代把 OPTIONS 本身用 404/405 拒掉,预检从第一步就失败。
在模拟器里勾选/取消 PUT,能看到失败停在预检阶段、正式请求行根本不出现——「服务器正常但日志为空」的典型特征。 CORS 模拟器