Python从.env加载Firebase服务账户时JSON解析错误解决咨询

问题分析 #

你遇到的json.loads()解析错误，核心原因是.env文件中存储的Firebase服务账户JSON字符串存在未正确处理的特殊字符（比如换行符、引号），导致JSON解析器无法识别。下面针对你的两个疑问给出具体解决方案：

1. .env文件存储服务账户字符串的特殊字符处理规范 #

直接将多行JSON粘贴到.env中会触发解析问题，推荐以下两种可靠处理方式：

• 方式一：单行JSON+单引号包裹
  1. 打开Firebase服务账户的JSON文件，去掉所有多余的换行符（仅保留private_key字段内的\n，这是私钥的必要组成部分），将JSON压缩为单行。
  2. 用单引号'将整个单行JSON字符串包裹，避免内部双引号与.env的变量定义冲突。
     示例.env内容：

  FIREBASE_CONFIG='{"type":"service_account","project_id":"your-project","private_key":"-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...\n-----END PRIVATE KEY-----\n","client_email":"xxx@your-project.iam.gserviceaccount.com","token_uri":"https://oauth2.googleapis.com/token"}'
  

• 方式二：base64编码存储
  将整个服务账户JSON文件编码为base64字符串，彻底规避特殊字符问题：
  1. 在终端执行命令（替换为你的JSON文件名）：

     base64 serviceAccountKey.json > firebase_config.b64
     

  2. 将生成的base64字符串复制到.env中：

     FIREBASE_CONFIG_B64="你的base64编码字符串"
     

2. 更稳健的Python加载方案 #

方案一：直接加载JSON文件（最推荐）

如果项目允许存放服务账户JSON文件，这是最省心的方式，完全避免字符串转义问题：

import firebase_admin
from firebase_admin import credentials

# 直接传入服务账户JSON文件路径
cred = credentials.Certificate("serviceAccountKey.json")
firebase_admin.initialize_app(cred)

方案二：base64解码加载

对应上面的base64存储方式，代码中解码后解析：

import firebase_admin
from firebase_admin import credentials
from dotenv import load_dotenv
import os, json, base64

load_dotenv()
# 读取base64字符串并解码
firebase_config_b64 = os.getenv("FIREBASE_CONFIG_B64")
firebase_config = json.loads(base64.b64decode(firebase_config_b64).decode("utf-8"))
cred = credentials.Certificate(firebase_config)
firebase_admin.initialize_app(cred)

方案三：拆分字段存储

将服务账户的关键字段单独存到.env中，手动构建配置字典，逐个处理特殊字符：
.env内容示例：

FIREBASE_TYPE="service_account"
FIREBASE_PROJECT_ID="your-project"
FIREBASE_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...\n-----END PRIVATE KEY-----\n"
FIREBASE_CLIENT_EMAIL="xxx@your-project.iam.gserviceaccount.com"
FIREBASE_TOKEN_URI="https://oauth2.googleapis.com/token"

Python代码：

import firebase_admin
from firebase_admin import credentials
from dotenv import load_dotenv
import os

load_dotenv()
# 手动构建配置字典，注意将private_key中的\\n替换为真实换行符
firebase_config = {
    "type": os.getenv("FIREBASE_TYPE"),
    "project_id": os.getenv("FIREBASE_PROJECT_ID"),
    "private_key": os.getenv("FIREBASE_PRIVATE_KEY").replace("\\n", "\n"),
    "client_email": os.getenv("FIREBASE_CLIENT_EMAIL"),
    "token_uri": os.getenv("FIREBASE_TOKEN_URI")
}
cred = credentials.Certificate(firebase_config)
firebase_admin.initialize_app(cred)

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