SvelteKit官方示例用--host选项时Cookie未设置致登录失败的解决办法

原因分析 #

当使用npm run dev -- --host启动服务时，应用会绑定到0.0.0.0，浏览器访问时通常用局域网IP（比如192.168.x.x）而非本地localhost，默认的Cookie配置未适配这种跨IP/域名场景，浏览器会因安全策略拒绝存储Cookie。

解决方案 #

1. 调整Cookie设置参数 #

找到项目中设置JWT Cookie的代码（一般在登录相关的服务端逻辑或API路由里），修改cookies.set的配置项，补充sameSite并按需配置domain：

cookies.set('jwt', value, {
  path: '/',
  sameSite: 'lax', // 兼容多数开发场景，若需跨域可设为'none'（但需同时开启secure）
  domain: process.env.NODE_ENV === 'development' ? undefined : 'your-production-domain.com'
});

• 开发环境domain设为undefined，浏览器会自动适配当前访问的IP/域名；生产环境替换为实际业务域名。
• sameSite: 'lax'既符合浏览器安全策略，又能保证Cookie在跨站点导航时正常生效。

2. 配置Vite服务器的Origin #

在项目根目录的vite.config.js中，指定服务器的origin为实际访问的IP和端口，确保Cookie的来源与页面一致：

import { sveltekit } from '@sveltejs/kit/vite';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [sveltekit()],
  server: {
    host: '0.0.0.0',
    origin: 'http://192.168.x.x:5173' // 替换成你实际访问的局域网IP和端口
  }
});

额外提示 #

如果浏览器强制要求Secure Cookie（如开启严格安全模式），开发环境可临时启用Vite的HTTPS（需生成自签名证书），或优先使用sameSite: 'lax'来规避问题。

内容的提问来源于stack exchange，提问作者Alok