看起来你遇到了一个很典型的代理头丢失问题，我来帮你一步步排查和解决：

先从最基础的排查开始 #

首先咱们得确认你的onProxyReq回调函数到底有没有执行——很多时候问题出在回调根本没触发，而不是头没加上。

你可以在回调里加两行调试日志，看看请求过来时会不会打印：

onProxyReq: (proxyReq, req, res) => {
  // 新增调试日志
  console.log("✅ 进入onProxyReq回调了！");
  console.log("要添加的API Key是：", API_KEY);
  
  proxyReq.setHeader('Api-Key', API_KEY);
},

启动代理服务后发个请求，如果控制台没看到这两行输出，那说明你的代理中间件可能没匹配到请求路径，或者挂载顺序有问题。

常见问题点分析 #

1. 头的大小写与服务器解析逻辑

HTTP头本身是不区分大小写的，但有些服务器框架会自动把所有头转成小写存储（比如Node.js的req.headers就是全小写键）。你目标服务的日志里没看到api-key（小写），说明头确实没传过去，但可以试试把头名改成全小写或者用标准的X-API-Key前缀，有些服务对自定义头的命名规范更敏感：

proxyReq.setHeader('x-api-key', API_KEY);

2. 请求体解析导致的流消耗问题

如果你的请求是POST/PUT这类带JSON体的请求，而你没在express里加body解析中间件，或者解析顺序在代理之后，可能会导致proxyReq的数据流被提前消耗，连带头的设置也失效了。

你可以在代理中间件之前加上body解析：

// 放在apiProxy定义之前
app.use(express.json());

如果已经加了解析，那还要在onProxyReq里手动重新写入请求体（因为express解析后会把req的流读完）：

onProxyReq: (proxyReq, req, res) => {
  console.log("✅ 进入onProxyReq回调了！");
  proxyReq.setHeader('x-api-key', API_KEY);
  
  // 如果请求有body，重新写入proxyReq
  if (req.body) {
    const bodyStr = JSON.stringify(req.body);
    proxyReq.setHeader('Content-Length', Buffer.byteLength(bodyStr));
    proxyReq.write(bodyStr);
    proxyReq.end();
  }
},

3. 代理中间件的挂载路径匹配问题

你把代理挂载在'/'路径下，理论上所有请求都会匹配，但如果你的express应用里还有其他路由（比如app.get('/hello', ...)）是在代理之前定义的，那请求会被先路由到其他处理逻辑，根本不会走到代理中间件。

确保app.use('/', apiProxy)是所有路由定义的最后一步。

验证目标服务的日志逻辑 #

最后再确认下目标服务的日志是不是真的打印了所有请求头——比如用Node.js的话，正确打印所有头的代码应该是这样的：

const http = require('http');
const server = http.createServer((req, res) => {
  // 打印所有请求头，包括自定义头
  console.log('收到的请求头：', req.headers);
  res.end('OK');
});
server.listen(8000);

按这个步骤排查下来，应该能找到问题所在。先从调试日志确认回调是否执行，这是最关键的第一步！