使用Express为localhost所有子域名设置Cookie失败求助

问题根源 #

浏览器对localhost这个保留主机名的Cookie Domain属性有特殊限制——它不属于常规顶级域名体系，无法通过设置domain: "localhost"、.localhost或*.localhost实现子域名共享，这就是你收到Domain attribute was invalid报错的原因。

可行解决方案 #

1. 自定义本地顶级域名

修改本地hosts文件，把需要的子域名映射到127.0.0.1，比如用.local作为顶级域名：

127.0.0.1 api.local
127.0.0.1 app.local
127.0.0.1 admin.local

2. 正确设置Cookie参数

设置Cookie时指定自定义的顶级域名前缀，同时修正expires参数（必须是Date对象，而非数字）：

res.cookie("smjwt", token, {
  expires: new Date(Date.now() + 3600 * 1000), // 1小时后过期
  sameSite: "none",
  secure: true,
  domain: ".local"
})

关键注意事项 #

• 必须启用HTTPS：sameSite: "none"要求Cookie必须是安全的，本地环境可以用mkcert生成自签名证书。
• 统一端口：所有子域名服务需使用相同端口，否则浏览器会视为不同站点，无法共享Cookie。

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