cors报错表明浏览器在javascript读取响应前已拦截跨域请求，需通过禁用安全策略、安装cors插件或配置vite代理解决。
你在本地开发前端项目时点击按钮调用后端接口，控制台立刻弹出红色报错“Access to XMLHttpRequest has been blocked by CORS policy”，Network面板里能看到请求已发出、服务器返回了200状态码但被标为(blocked:cors)，说明浏览器在响应到达JavaScript前就切断了数据通路，必须让请求绕过或骗过这道安检。
命令行启动无安全限制会话
第一步：彻底关闭所有Chrome进程。Windows用户打开任务管理器→“详细信息”页签→结束全部chrome.exe；macOS用户打开活动监视器→搜索“Google Chrome”→选中全部实例→强制退出。这一步漏掉任一后台进程，后续命令都会失效。
第二步：执行对应系统命令，【必须使用全新的--user-data-dir路径，重复使用旧路径将导致--disable-web-security完全不生效】。Windows示例：chrome.exe --user-data-dir="C:\ChromeDevSession" --disable-web-security；macOS示例：open -n -a "Google Chrome" --args --user-data-dir="/tmp/chrome_dev_test" --disable-web-security。
第三步：新窗口启动后，若地址栏下方出现黄色提示条“您使用的是不受支持的命令行标记”，即表示同源策略已禁用成功。此时可直接打开本地HTML文件或访问localhost不同端口的API，CORS拦截消失。
安装可信CORS扩展快速放行
方法一：打开Chrome网上应用店，搜索并安装CORS Unblocked（开发者Ritwick Dey）或Allow CORS: Access-Control-Allow-Origin。
方法二：点击浏览器右上角拼图图标→找到刚安装的插件→点击右侧开关启用。注意：部分新版Chrome要求先点击插件图标，在弹出面板中手动将模式切换为“Enable CORS”，否则开关看似开启但实际未生效。
方法三：刷新当前页面，观察控制台是否清除CORS报错。该方案不修改浏览器底层策略，仅对匹配域名的响应头注入Access-Control-Allow-Origin: *，适合日常轻量调试。
Vite项目配置开发代理（推荐长期使用）
① 打开项目根目录下的vite.config.ts文件；
② 在server.proxy配置项中添加如下块：proxy: { '/api': { target: 'http://localhost:8080', changeOrigin: true } }；
③ 保存文件并重启Vite开发服务器。此后所有以/api开头的请求，都将被Vite截获并转发至http://localhost:8080，浏览器判定为同源请求，不再触发CORS检查。
关闭私有网络拦截策略
Chrome 94+版本默认启用Block insecure private network requests策略，导致访问localhost、127.0.0.1或内网IP（如192.168.x.x）时被额外拦截，错误提示含“more-private address space `local`”字样。
在地址栏输入chrome://flags/#block-insecure-private-network-requests→将其设为Disabled→点击Relaunch按钮重启浏览器。
若此法在Chrome 108+版本失效，则改用命令行启动：chrome.exe --disable-features=BlockInsecurePrivateNetworkRequests --user-data-dir="C:\ChromeDevSession"（Windows）或open -n -a "Google Chrome" --args --disable-features=BlockInsecurePrivateNetworkRequests --user-data-dir="/tmp/chrome_dev_test"（macOS）。
