如何为FireStore的getDocs()请求手动添加认证头？

直接给出结论：Firebase官方Web SDK中的getDocs()方法不支持在调用时手动传入Authorization请求头。

原因很明确：Firestore SDK和Firebase Auth深度集成，会自动处理认证令牌的附加、过期刷新等逻辑。所有通过SDK发起的请求，认证信息都是基于当前Firebase Auth实例的用户状态自动添加的，不会开放手动设置请求头的入口。

如果你已经持有有效的访问令牌，有两种可行的处理方式：

1. 通过Firebase Auth管理认证状态 #

如果你的令牌是Firebase自定义令牌或ID令牌，可以先通过Auth实例设置当前用户的认证状态，之后所有SDK请求都会自动带上认证信息：

import { signInWithCustomToken } from "firebase/auth";

// 使用自定义令牌完成登录
await signInWithCustomToken(auth, 你的有效令牌);

// 后续调用getDocs无需额外处理，SDK自动附加认证头
const citiesCol = collection(db, "cities");
const citySnapshot = await getDocs(citiesCol);
const cityList = citySnapshot.docs.map(doc => doc.data());

2. 直接调用Firestore REST API #

如果不想依赖Firebase Auth的集成，可以直接调用Firestore的REST接口，这时就能手动设置Authorization请求头：

const projectId = "你的Firebase项目ID";
const token = "你的有效访问令牌";

// 请求cities集合的所有文档
const response = await fetch(`https://firestore.googleapis.com/v1/projects/${projectId}/databases/(default)/documents/cities`, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  }
});

const result = await response.json();
// 自行处理返回的文档数据（需手动解析结构，不像SDK那样直接返回Snapshot）

这种方式需要你自己处理数据序列化、分页、错误处理等细节，没有SDK封装得便捷，但完全支持手动控制请求头。

总结：SDK层面不支持手动添加请求头，但可以通过Auth管理状态让SDK自动处理，或者改用REST API实现手动控制。

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