基于Express Session值为Axios设置请求头调用Java后端

针对你遇到的Express SSR中Axios无法获取请求session来设置全局请求头的问题，这里提供一个无需修改现有API调用结构的解决方案，核心是利用Node.js的异步上下文存储来共享请求信息。

方案一：使用Node.js原生AsyncLocalStorage（推荐） #

Node.js v14.17.0及以上版本原生支持AsyncLocalStorage，可以在异步调用链中安全共享请求上下文，让Axios拦截器能获取到当前请求的session。

1. 实现请求上下文管理 #

新建request-context.js文件：

const { AsyncLocalStorage } = require('async_hooks');

const storage = new AsyncLocalStorage();

// 注入当前请求到上下文
exports.bindRequest = (req, res, next) => {
  storage.run(new Map(), () => {
    storage.getStore().set('req', req);
    next();
  });
};

// 获取当前请求上下文
exports.getRequest = () => {
  return storage.getStore()?.get('req');
};

2. 在Express中挂载上下文中间件 #

确保这个中间件在session中间件之后注册，这样才能拿到已初始化的req.session：

const express = require('express');
const session = require('express-session');
const { bindRequest } = require('./request-context');
const app = express();

// 先配置session中间件
app.use(session({
  secret: 'your-secret-key',
  resave: false,
  saveUninitialized: false
}));

// 挂载请求上下文中间件
app.use(bindRequest);

3. 修改Axios拦截器获取上下文 #

在你的Axios封装模块（比如api-client.js）中，修改请求拦截器：

const axios = require('axios');
const { getRequest } = require('./request-context');

const javaApiClient = axios.create({
  baseURL: 'http://your-java-backend-url'
});

javaApiClient.interceptors.request.use(config => {
  const currentReq = getRequest();
  // 从session中取出agent-id，键名根据你的实际存储调整
  if (currentReq?.session?.['agent-id']) {
    config.headers['agent-id'] = currentReq.session['agent-id'];
  }
  return config;
});

module.exports = javaApiClient;

这样所有通过javaApiClient发起的请求都会自动带上agent-id头，完全不需要修改现有API调用代码。

方案二：兼容低Node.js版本（使用cls-hooked） #

如果你的Node.js版本低于v14.17.0，可以用cls-hooked这个第三方库实现相同逻辑，它是async_hooks的封装：

1. 安装依赖 #

npm install cls-hooked

2. 实现上下文管理 #

新建request-context.js：

const cls = require('cls-hooked');

const namespace = cls.createNamespace('express-request-context');

exports.bindRequest = (req, res, next) => {
  namespace.run(() => {
    namespace.set('req', req);
    next();
  });
};

exports.getRequest = () => {
  return namespace.get('req');
};

后续的Express中间件挂载和Axios拦截器修改和方案一完全一致，只是替换了上下文存储的实现。

注意事项 #

• 确保上下文中间件在session、cookie解析等中间件之后执行，否则req.session还未初始化。
• 如果你的应用中有异步任务（比如定时器、队列），只要这些任务是在请求处理的异步链中触发的，AsyncLocalStorage就能正确传递上下文；如果是脱离请求链的异步任务，可能需要手动传递上下文。

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