Firebase Hosting代理云函数时If-None-Match头被过滤，如何解决？

核心问题根因 #

通过Firebase Hosting的友好URL访问关联的Cloud Functions时，Hosting层会自动过滤If-None-Match请求头；但直接访问云函数的原生域名（us-central1-<project>.cloudfunctions.net）时，该头可以正常传递到函数中。

可行解决方案 #

方案1：直接使用云函数原生域名 #

如果业务允许放弃Hosting的友好URL，直接让客户端调用us-central1-<project>.cloudfunctions.net域名，If-None-Match头会完整到达云函数，无需修改任何代码即可实现ETag逻辑。

方案2：自定义请求头映射（保留Hosting URL） #

目前没有官方配置可以禁用Hosting对If-None-Match的过滤，只能通过自定义头做变通。在Express中间件中添加映射逻辑，将客户端发送的X-If-None-Match头值转成If-None-Match，后端ETag校验逻辑无需改动：

// 在Express应用的最上方添加此中间件
app.use((req, res, next) => {
  if (req.headers['x-if-none-match']) {
    req.headers['if-none-match'] = req.headers['x-if-none-match'];
  }
  next();
});

Node.js第二代云函数的情况 #

第二代云函数（基于Cloud Run架构）本身支持If-None-Match请求头的传递，但如果仍然通过Firebase Hosting路由流量，依然会出现相同的头被过滤问题——因为过滤逻辑属于Firebase Hosting层，和云函数的代际无关。

内容的提问来源于stack exchange，提问作者Frédéric Camblor