将Firebase配置改为process.env后无法连接Cloud Firestore后端

• 先确认环境变量是否正确加载
  在Firebase初始化代码前添加日志，打印所有需要的环境变量值：

  console.log('Firebase API Key:', process.env.FIREBASE_API_KEY);
  console.log('Firebase Project ID:', process.env.FIREBASE_PROJECT_ID);
  

  检查输出是否为预期的有效值，避免出现undefined或空字符串。同时确认环境变量文件（如.env）放置在项目根目录，且符合框架要求（比如React项目变量需以REACT_APP_开头，Node.js项目需确保dotenv包已安装并在初始化前执行require('dotenv').config()）。

• 验证Firebase配置对象完整性
  将加载后的配置对象完整打印出来，和之前硬编码的配置逐一对比：

  const firebaseConfig = {
    apiKey: process.env.FIREBASE_API_KEY,
    authDomain: process.env.FIREBASE_AUTH_DOMAIN,
    projectId: process.env.FIREBASE_PROJECT_ID,
    storageBucket: process.env.FIREBASE_STORAGE_BUCKET,
    messagingSenderId: process.env.FIREBASE_MESSAGING_SENDER_ID,
    appId: process.env.FIREBASE_APP_ID
  };
  console.log('Firebase Config:', firebaseConfig);
  

  确保所有必填字段都存在、拼写正确，没有因环境变量名写错导致的配置缺失。

• 排查环境变量加载时机
  前端项目需确认环境变量是在构建阶段注入的，而非运行时动态读取；Node.js项目要保证环境变量在Firebase初始化代码之前完成加载，避免因加载顺序问题导致配置为空。

• 移除无效实验性配置
  先去掉experimentalForceLongPolling: true和useFetchStreams: false这些实验性设置，回到基础初始化代码。因为当前问题根源大概率是配置错误，而非传输协议问题，先排除配置因素再调试传输相关设置。

• 交叉验证问题根源
  临时换回硬编码的Firebase配置，测试是否能正常连接Firestore。如果硬编码能正常工作，说明问题完全出在环境变量加载环节；如果仍失败，再排查Firebase项目权限、网络环境等其他因素。

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