部署在Firebase App Hosting的Next.js无法设置Cookie，求解决方案

• 强制使用__session作为Cookie名称：Firebase Hosting仅支持以__session命名的Cookie，需确保拼写完全正确（全小写+双下划线），无大小写错误。
• 配置Next.js响应头规则：在next.config.js中添加Cookie相关的响应头配置，适配Firebase Hosting的HTTPS环境：

  module.exports = {
    async headers() {
      return [
        {
          source: '/(.*)',
          headers: [
            {
              key: 'Set-Cookie',
              value: '__session=your-cookie-content; Path=/; HttpOnly; Secure; SameSite=Strict',
            },
          ],
        },
      ];
    },
  };
  

  其中Secure属性在Firebase生产环境必须添加，本地开发可临时移除；SameSite可根据业务需求调整为Lax或None（设置为None时需同时保留Secure）。
• 通过Firebase Functions中转请求：若直接在Next.js路由中设置Cookie无效，可借助Firebase Functions作为中间层处理：
  1. 编写Functions代码：

     // functions/index.js
     const functions = require('firebase-functions');
     const next = require('next');
     const app = next({ dev: false });
     const handle = app.getRequestHandler();
     
     exports.nextApp = functions.https.onRequest((req, res) => {
       res.setHeader('Set-Cookie', '__session=your-cookie-content; Path=/; HttpOnly; Secure; SameSite=Strict');
       return handle(req, res);
     });
     

  2. 修改firebase.json将请求转发至该Function：

     {
       "hosting": {
         "public": "out",
         "rewrites": [
           {
             "source": "**",
             "function": "nextApp"
           }
         ]
       }
     }
     

• 排除动态页面缓存：Firebase Hosting的缓存机制可能导致Cookie设置失效，需在firebase.json中为需要设置Cookie的页面/api添加缓存禁用规则：

  {
    "hosting": {
      "public": "out",
      "headers": [
        {
          "source": "/api/**",
          "headers": [
            {
              "key": "Cache-Control",
              "value": "no-cache, no-store, must-revalidate"
            }
          ]
        },
        {
          "source": "/dynamic-path/**",
          "headers": [
            {
              "key": "Cache-Control",
              "value": "no-cache, no-store, must-revalidate"
            }
          ]
        }
      ]
    }
  }
  

• 校验Cookie设置代码：确保在Next.js的API路由或getServerSideProps中使用标准的res.setHeader方法设置Cookie，示例如下：

  // pages/api/set-cookie.js
  export default function handler(req, res) {
    res.setHeader('Set-Cookie', '__session=test-value; Path=/; HttpOnly; Secure; SameSite=Strict');
    res.status(200).json({ status: 'success' });
  }
  

  若使用第三方Cookie库，需确认其生成的Set-Cookie头符合Firebase的要求。

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