NodeJS/Express无法读取请求头userid问题求助

1. CORS配置未放行userid自定义头 #

Express的cors中间件默认只允许标准HTTP头和部分带X-前缀的自定义头。如果你的请求头是userid（无X-前缀），必须在后端CORS配置里显式声明允许这个头：

const cors = require('cors');
app.use(cors({
  allowedHeaders: ['x-access-token', 'userid'],
  credentials: true
}));

哪怕前端请求里能看到这个头，只要CORS没放行，后端就无法读取。

2. 头字段大小写不匹配 #

Node.js会把所有请求头转成全小写存储在req.headers里。如果后端用req.headers.UserId或req.headers.USERID读取，必然返回undefined，必须用req.headers.userid来获取。

3. Axios请求头配置有误 #

检查前端Axios的写法，确保头字段正确赋值且格式无误：

// 单个请求配置示例
axios.get('/api/todos', {
  headers: {
    'x-access-token': yourToken,
    'userid': yourUserId // 注意引号，避免和变量名冲突
  }
});

如果用全局拦截器，要确认拦截器里没有遗漏或覆盖userid：

axios.interceptors.request.use(config => {
  config.headers['x-access-token'] = localStorage.getItem('token');
  config.headers['userid'] = localStorage.getItem('userId'); // 这里要正确赋值
  return config;
});

4. 后端中间件顺序错误 #

如果认证中间件在CORS中间件之前执行，此时CORS还未处理自定义头，会导致读取失败。必须保证CORS中间件是第一个被注册的：

// 正确顺序
app.use(cors(...)); // 先注册CORS
app.use(authMiddleware); // 再注册认证中间件
app.use('/api', routes);

5. 代理服务器过滤了头字段 #

如果前端用了开发代理（比如React的setupProxy.js），或后端有Nginx这类反向代理，要确认代理配置没有过滤userid。比如Nginx需要添加：

proxy_set_header userid $http_userid;

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