Next JS结合Firebase Hosting：如何为SSR配置自定义域名？

• 先确认Cloud Function状态

  • 登录Firebase控制台，进入Cloud Functions页面，检查ssrfunction是否处于活跃状态，查看函数日志有没有报错。
  • 直接访问函数的原生URL（格式：https://<你的函数区域>-<项目ID>.cloudfunctions.net/ssrfunction），测试能否正常返回页面内容。如果函数本身报错，Hosting转发必然失效。

• 验证部署完整性

  • 确认部署时执行了完整命令：firebase deploy --only hosting,functions，确保Hosting和Cloud Function都完成部署，而非仅部署其中一项。
  • 查看Firebase Hosting的部署记录，确认最新部署已成功完成，无失败提示。

• 检查firebase.json配置细节

  • 核对function字段的函数名是否与Cloud Functions中的名称完全一致（大小写敏感），比如函数实际命名为ssrFunction的话，配置里的小写会导致匹配失败。
  • 若使用Next.js 13+ App Router，需添加frameworksBackend字段指定函数区域：

    {
      "hosting": {
        "source": ".",
        "frameworksBackend": {
          "region": "us-central1" // 替换为你的函数实际部署区域
        },
        "rewrites": [
          {
            "source": "**",
            "function": "ssrfunction"
          }
        ],
        "ignore": [
          "firebase.json",
          "**/.*",
          "**/node_modules/**"
        ]
      }
    }
    

  • 若函数部署在非默认区域（如europe-west1），需在rewrite规则中指定区域：

    {
      "source": "**",
      "function": "ssrfunction",
      "region": "europe-west1"
    }
    

• 自定义域名额外检查

  • 确认自定义域名已在Firebase Hosting完成验证，SSL证书状态显示已激活。
  • 检查域名DNS记录是否正确配置（A记录或CNAME指向Firebase提供的目标），可通过dig等工具验证DNS是否生效。

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