Next.js+Firebase项目出现Error: Service firestore is not available问题求助

以下是几种贴合你场景的排查方向（代码和配置未改动的前提下）：

1. Firebase依赖版本冲突或自动更新问题 #

即使没手动修改依赖，npm/yarn重新安装时可能拉取了不兼容的SDK版本，或各Firebase模块版本不一致：

• 检查package.json中firebase、@firebase/auth、@firebase/firestore等相关包的版本，确保所有Firebase依赖版本完全一致。
• 删除node_modules、package-lock.json（或yarn.lock），重新执行npm install（或yarn install），强制锁定统一版本。

2. 环境变量未正确加载 #

Next.js的环境变量可能在部分场景下未被正确注入，导致Firebase初始化参数缺失：

• 在Firebase初始化代码前添加console.log(firebaseConfig)，确认所有字段（尤其是projectId）均为有效值，而非undefined。
• 检查.env.local文件是否存在，变量名是否完全匹配（注意大小写），确认未误删或清空变量值。

3. Firebase项目的Firestore服务被意外变更 #

可能存在团队操作或平台侧的隐性变化：

• 登录Firebase控制台，进入对应项目，查看Firestore数据库的状态是否为「已启用」。
• 检查Firebase项目的配额使用情况，确认是否因超限导致Firestore服务被临时限制。

4. Next.js缓存残留引发异常 #

开发环境或构建缓存可能保留了旧的初始化逻辑：

• 删除.next文件夹，重启next dev开发服务器。
• 若问题出现在生产环境，执行next build && next start重新构建并启动服务，规避缓存影响。

5. 网络或防火墙拦截 #

本地网络环境变化可能导致无法连接Firestore服务：

• 切换到其他网络（如手机热点）测试，排除公司网络或本地防火墙的拦截。
• 检查本地代理设置，确认未拦截Firebase相关域名的请求。

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