Express基于express-session的同根域子域名会话共享失效问题排查
逐点排查与修复方案
1. 优先校验跨站点的session核心配置一致性
该类故障最常见的根因为两边服务的核心配置不匹配,直接导致已存在的会话被判定为无效,触发空会话覆盖逻辑:
- 确保dashboard.example.com和x.example.com两个后端服务的
secret值完全一致。如果两边secret不匹配,express-session解析cookie中的会话ID时会因为HMAC签名校验不通过,直接将携带的有效sid判定为非法值,进而创建空会话;加上saveUninitialized: true的配置,空会话会被直接写入Redis,刚好覆盖原有的有效登录数据 - 确保两边的
name值、redisStore配置完全统一,包括连接的Redis实例、数据库编号、存储键前缀、序列化规则,避免出现“同sid但读取路径不一致”的问题 - 验证方式:直接连接Redis实例,在dashboard站点登录后查询存储的会话键位置,对比x.example.com服务默认的会话读取路径,确认两边完全重合
2. 修复不符合浏览器规范的跨域配置
当前自定义的跨域中间件存在硬伤,会直接干扰携带凭证的请求处理:
- 浏览器规范明确禁止同时设置
Access-Control-Allow-Origin: *和Access-Control-Allow-Credentials: true,该配置下浏览器会直接拦截携带cookie的跨域AJAX请求,导致后续会话验证失效 - 正确的跨域中间件实现参考:
const TRUSTED_ORIGIN_REGEX = /\.example\.com$/ app.use((req, res, next) => { const reqOrigin = req.headers.origin if (TRUSTED_ORIGIN_REGEX.test(reqOrigin)) { res.header('Access-Control-Allow-Origin', reqOrigin) } res.header('Access-Control-Allow-Credentials', true) res.header('Access-Control-Allow-Methods', 'GET,PUT,POST,DELETE') res.header('Access-Control-Allow-Headers', 'X-Requested-With, X-HTTP-Method-Override, Content-Type, Accept') next() })
3. 校验NGINX反向代理的请求透传逻辑
后端已开启proxy: true配置,依赖反向代理透传的协议头判断请求安全性,如果透传逻辑有问题会直接导致cookie被丢弃:
- 确保NGINX转发请求时,完整透传
X-Forwarded-Proto头,且头值为用户原始请求的HTTPS协议;如果后端识别到请求为HTTP协议,会直接丢弃设置了secure: true的cookie,进而生成新会话 - 可临时在后端增加中间件打印所有请求头,对比两个子域名访问时的头值,确认透传逻辑符合预期
4. 修正session配置中的错误参数
- 删除cookie配置中的
expires字段。该字段是Express中间件初始化时一次性计算的固定时间值,服务长期运行后会导致cookie提前过期;会话过期逻辑统一由maxAge参数动态控制即可 - 可临时将
resave和saveUninitialized设置为false,验证是否因为空会话频繁写入Redis,导致原有有效会话被意外覆盖
5. 故障复现验证步骤
- 完成dashboard站点登录后,直接在Redis客户端查询对应会话键的存储值,确认内容为非空的用户登录信息
- 从x.example.com发起请求时,在后端打印
req.session.id值,对比dashboard站点生成的会话ID,确认两者完全一致 - 观察后端会话处理日志,定位会话读取失败的具体原因,排除签名校验、存储路径、协议识别类的问题
内容的提问来源于stack exchange,提问作者Tom Nipravsky
相关产品推荐
相关产品推荐

