Firebase Hosting+Cloud Functions返回404时出现500错误求助

本地测试正常，但部署到线上后出现以下异常：

• 访问https://xxxx.web.app/myfunction/hello可正常返回"hello world"
• 访问https://xxxx.web.app/myfunction/404返回500错误而非预期的404
• 本地访问http://localhost/myfunction/404可正常返回自定义404

相关代码与配置 #

index.js #

const functions = require('firebase-functions');

exports.myfunction = functions.region('asia-east1').runWith({maxInstances: 2}).https.onRequest((request, response) => {
    if (request.path == '/myfunction/hello') {
        return response.send("hello world")
    }

    response.set('X-Cascade', 'PASS');
    return response.status(404).end()
});

firebase.json #

{
  "functions": [
    {
      "source": "functions",
      "codebase": "default",
      "ignore": [
        "node_modules",
        ".git",
        "firebase-debug.log",
        "firebase-debug.*.log"
      ]
    }
  ],
  "hosting": {
    "public": "public",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],
    "rewrites": [
      {
        "source": "/myfunction/*",
        "function": "myfunction",
        "region": "asia-east1"
      }
    ]
  }
}

文件结构 #

.
├── firebase.json
├── functions
│   ├── index.js
│   └── package.json
└── public
    ├── 404.html
    └── index.html

问题原因与修复方法 #

问题出在两个点：

1. 路径匹配偏差：本地模拟器会保留完整的/myfunction/xxx路径，但线上部署后，Firebase Hosting的重写规则会剥离/myfunction/前缀，传递给Cloud Functions的request.path实际是/hello或/404。原代码中判断request.path == '/myfunction/hello'在本地有效，但线上只有/hello会命中，其他路径都会进入404分支。

2. X-Cascade: PASS的冲突：设置这个头后，Firebase Hosting会尝试继续寻找其他匹配规则或静态文件，但如果没有找到，会返回500错误，而非直接转发函数的404响应。

修复步骤： #

• 修正路径判断逻辑，去掉/myfunction前缀：
• 移除X-Cascade: PASS头，让函数直接返回404状态码给客户端。

修改后的index.js：

const functions = require('firebase-functions');

exports.myfunction = functions.region('asia-east1').runWith({maxInstances: 2}).https.onRequest((request, response) => {
    if (request.path == '/hello') {
        return response.send("hello world")
    }

    return response.status(404).end()
});

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