CORS 是浏览器强制实施的安全机制，非 JS 问题；跨域请求需服务端配置 Access-Control-Allow-Origin 等响应头，否则请求被拦截；预检请求（OPTIONS）在非简单请求时触发，需服务端正确响应；前端仅能通过代理或 credentials 配合服务端实现合规跨域。
浏览器会直接拦截跨域请求，不是 JavaScript “解决”了 CORS，而是你得按浏览器的规则来发请求、配服务端——否则连请求都发不出去。
为什么 fetch 或 XMLHttpRequest 会报 CORS 错误
这不是 JS 的 bug，是浏览器的安全机制：当协议、域名、端口任一不同，就视为跨域；此时若响应头不含 Access-Control-Allow-Origin，浏览器就拒绝把响应内容交给 JS。
常见错误现象：
- 控制台报错
Blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present - Network 面板里请求状态显示
(failed) net::ERR_FAILED或preflight is invalid -
fetch()抛出 TypeError，但catch捕不到（因为请求根本没完成）
哪些请求会触发预检（OPTIONS）
只要满足以下任一条件，浏览器会在发主请求前自动发一个 OPTIONS 预检请求：
立即学习“Java免费学习笔记（深入）”；
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 使用了非简单方法（如
PUT、DELETE、PATCH） - 设置了自定义请求头（如
Authorization、X-Request-ID） - Content-Type 不是
application/x-www-form-urlencoded、multipart/form-data或text/plain
服务端必须正确响应这个 OPTIONS 请求，返回 204 或 200，且带上 Access-Control-Allow-Methods、Access-Control-Allow-Headers 等头，否则预检失败，主请求不会发出。
前端能做的有限操作：mode 和 credentials
JS 侧唯一可控的“绕过”方式，是告诉浏览器：“这次请求不需要 CORS 检查”——但这只适用于同源或已配好代理的场景：
- 开发时用
mode: 'no-cors'？不行。它会让响应变成opaque类型，JS 读不到任何数据，只适合发埋点日志这类单向请求 - 需要带 Cookie？必须同时设
credentials: 'include'，且服务端响应头必须明确写Access-Control-Allow-Credentials: true（此时Access-Control-Allow-Origin不能为*） - 真正有效的做法是：开发期用本地代理（如 vite.config.ts 中的
server.proxy），把/api代理到后端地址，让请求看起来是同源的
示例（Vite 代理配置）：
server: {
proxy: {
'/api': {
target: 'http://localhost:3000',
changeOrigin: true,
rewrite: (path) => path.replace(/^\/api/, '')
}
}
}
CORS 的本质是服务端责任
前端改 headers、加 mode、换 fetch 写法，都无法让浏览器放行一个没配好的跨域响应。最常被忽略的一点是：CORS 头必须由后端在响应中设置，且要覆盖所有必要路径（比如静态资源、健康检查接口也得有，否则预检可能卡在 /health 上）。
如果你没有后端权限，那就只能走代理；如果有的话，别只在主接口加头，检查 OPTIONS 路由是否被中间件拦截、是否遗漏了通配符或凭证支持。
