本地用 Vite 起前端服务，后端跑在另一个端口，接口通过 `server.proxy` 转发。登录接口返回 `Set-Cookie`，浏览器 Network 面板里能看到响应头，但后续请求就是不带 Cookie，导致接口一直返回 401。这个问题在前后端分离的本地联调里很常见，原因通常不是后端没写 Cookie，而是代理层没有正确传递 `Set-Cookie` 的 Domain 和 Path，或者前端请求没开启 `credentials`，再或者跨域响应头里 `Access-Control-Allow-Origin` 写成了 `*` 导致浏览器直接丢弃凭据。下面把这条链路上容易出错的几个点拆开讲，并给出 Vite 代理和前端 fetch/axios 两侧的配置写法。

先看一个典型的 Vite 代理配置：

```js
// vite.config.js
export default defineConfig({
 server: {
 proxy: {
 '/api': {
 target: 'http://127.0.0.1:8080',
 changeOrigin: true,
 rewrite: (path) => path.replace(/^\/api/, ''),
 },
 },
 },
})
```

`changeOrigin: true` 会把请求头里的 Host 改成 target 的 host，这本身没问题，但它不会改 `Set-Cookie` 里的 Domain。如果后端登录接口返回的是 `Set-Cookie: sessionId=xxx; Domain=127.0.0.1; Path=/`，而浏览器页面地址是 `http://localhost:5173`，浏览器会认为这个 Cookie 属于 `127.0.0.1` 而不是 `localhost`，于是拒绝保存。端口不同不影响 Cookie 的域匹配，Cookie 不区分端口，只看 domain 和 path。所以本地开发时，要么把页面访问地址和代理目标统一成同一个 host，要么让后端在开发环境不写 Domain 属性，交给浏览器按当前 host 处理。

另一个常见坑是 `cookieDomainRewrite`。Vite 代理基于 http-proxy，支持这个选项：

```js
proxy: {
 '/api': {
 target: 'http://127.0.0.1:8080',
 changeOrigin: true,
 cookieDomainRewrite: 'localhost',
 rewrite: (path) => path.replace(/^\/api/, ''),
 },
}
```

这样代理会把响应里 `Set-Cookie` 的 Domain 重写成 `localhost`，浏览器就能把 Cookie 存到当前页面域下。如果后端返回的 Cookie 没带 Domain，`cookieDomainRewrite` 也能起作用，但要注意它只处理 `Set-Cookie` 响应头，不处理请求头里的 `Cookie`，请求方向的 Cookie 由浏览器自动带上。

前端请求侧必须带凭据。用 fetch 时：

```js
await fetch('/api/login', {
 method: 'POST',
 credentials: 'include',
 headers: { 'Content-Type': 'application/json' },
 body: JSON.stringify({ username, password }),
})
```

用 axios 时：

```js
axios.defaults.withCredentials = true
```

少了这个，浏览器即使收到了 `Set-Cookie`，后续同源请求（经过代理后对浏览器来说仍是同源）也会带 Cookie，但如果你在开发时直接请求了后端绝对地址而不是走代理，就会变成跨域请求，此时 `credentials: 'include'` 和响应头 `Access-Control-Allow-Credentials: true` 缺一不可，并且 `Access-Control-Allow-Origin` 不能是 `*`，必须是具体源。

还有一种情况是 Cookie 的 `SameSite` 属性。Chrome 从 80 版本开始默认把没有声明 `SameSite` 的 Cookie 当作 `Lax`，跨站请求不会带上。本地通过代理访问时浏览器视角是同源，一般不受影响，但如果前端页面和后端接口在开发时被配置成不同站点（比如一个用 `localhost`，一个用 `127.0.0.1`），就会被判定为跨站，`Lax` 下 POST 请求不带 Cookie。把后端开发环境的 Cookie 显式设为 `SameSite=Lax` 或 `SameSite=None; Secure`（后者需要 HTTPS）能避免歧义，不过本地 HTTP 下 `Secure` 的 Cookie 会被直接丢弃，所以开发环境更稳妥的做法还是统一 host 并让 Cookie 不带 Domain。

排查时可以按这个顺序看：浏览器 Application 面板里 Cookie 是否存在、Domain 和 Path 是否匹配当前页面、请求头里有没有 `Cookie`、响应头里 `Set-Cookie` 的完整内容、以及前端请求有没有开 `credentials`。多数情况下问题就卡在 Domain 不匹配或没开 `credentials` 这两处。

```js
// 后端 Spring Boot 开发环境设置 Cookie 的写法示例
ResponseCookie cookie = ResponseCookie.from("sessionId", sessionId)
 .httpOnly(true)
 .path("/")
 .sameSite("Lax")
 .build();
response.addHeader(HttpHeaders.SET_COOKIE, cookie.toString());
```

这段代码没有写 `domain`，浏览器会按当前请求的 host 存 Cookie。配合 Vite 的 `cookieDomainRewrite: 'localhost'`，本地联调基本不会再出现登录后掉线的问题。

 推荐查看成语：https://www.tianqi556.com/chengyu/9501.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9502.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9503.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9504.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9505.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9506.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9507.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9508.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9509.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9510.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9511.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9512.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9513.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9514.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9515.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9516.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9517.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9518.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9519.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9520.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9521.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9522.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9523.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9524.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9525.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9526.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9527.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9528.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9529.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9530.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9531.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9532.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9533.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9534.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9535.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9536.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9537.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9538.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9539.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9540.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9541.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9542.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9543.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9544.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9545.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9546.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9547.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9548.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9549.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9550.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9551.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9552.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9553.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9554.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9555.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9556.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9557.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9558.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9559.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9560.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9561.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9562.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9563.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9564.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9565.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9566.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9567.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9568.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9569.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9570.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9571.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9572.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9573.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9574.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9575.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9576.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9577.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9578.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9579.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9580.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9581.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9582.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9583.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9584.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9585.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9586.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9587.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9588.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9589.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9590.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9591.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9592.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9593.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9594.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9595.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9596.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9597.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9598.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9599.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9600.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9601.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9602.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9603.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9604.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9605.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9606.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9607.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9608.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9609.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9610.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9611.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9612.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9613.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9614.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9615.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9616.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9617.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9618.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9619.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9620.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9621.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9622.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9623.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9624.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9625.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9626.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9627.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9628.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9629.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9630.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9631.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9632.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9633.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9634.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9635.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9636.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9637.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9638.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9639.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9640.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9641.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9642.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9643.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9644.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9645.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9646.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9647.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9648.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9649.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9650.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9651.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9652.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9653.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9654.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9655.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9656.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9657.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9658.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9659.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9660.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9661.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9662.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9663.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9664.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9665.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9666.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9667.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9668.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9669.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9670.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9671.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9672.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9673.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9674.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9675.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9676.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9677.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9678.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9679.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9680.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9681.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9682.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9683.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9684.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9685.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9686.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9687.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9688.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9689.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9690.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9691.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9692.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9693.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9694.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9695.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9696.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9697.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9698.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9699.html
 推荐查看成语：https://www.tianqi556.com/chengyu/9700.html

本地用 Vite 起前端服务，后端跑在另一个端口，接口通过 server.proxy 转发。登录接口返回 Set-Cookie，浏览器 Network 面板里能看到响应头，但后续请求就是不带 Cookie，导致接口一直返回 401。这个问题在前后端分离的本地联调里很常见，原因通常不是后端没写 Cookie，而是代理层没有正确传递 Set-Cookie 的 Domain 和 Path，或者前端请求没开启 credentials，再或者跨域响应头里 Access-Control-Allow-Origin 写成了 * 导致浏览器直接丢弃凭据。下面把这条链路上容易出错的几个点拆开讲，并给出 Vite 代理和前端 fetch/axios 两侧的配置写法。

Vite 开发服务器代理跨域时 Cookie 丢失的排查与解决

本地用 Vite 起前端服务，后端跑在另一个端口，接口通过 server.proxy 转发。登录接口返回 Set-Cookie，浏览器 Network 面板里能看到响应头，但后续请求就是不带 Cookie，导致接口一直返回 401。这个问题在前后端分离的本地联调里很常见，原因通常不是后端没写 Cookie，而是代理层没有正确传递 Set-Cookie 的 Domain 和 Path，或者前端请求没

前端

网络与通信

开发工具

Vite代理登录后Cookie丢失返回401的解决方案，涵盖Set-Cookie的Domain不匹配、credentials未开启及跨域凭据限制等核心问题。通过cookieDomainRewrite:'localhost'重写Cookie域，配合fetch/axios的withCredentials配置，并统一前后端host避免SameSite限制，可有效解决本地联调中浏览器拒绝存储Cookie的常见故障。

代码解释

JSON

Vite

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Vite代理登录后Cookie丢失返回401的解决方案，涵盖Set-Cookie的Domain不匹配、credentials未开启及跨域凭据限制等核心问题。通过cookieDomainRewrite:'localhost'重写Cookie域，配合fetch/axios的withCredentials配置，并统一前后端h...

Vite 开发服务器代理跨域时 Cookie 丢失的排查与解决-腾讯云开发者社区-腾讯云

Vite 开发服务器代理跨域时 Cookie 丢失的排查与解决

Vite 开发服务器代理跨域时 Cookie 丢失的排查与解决

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐