Django应用中使用.env文件初始化Firebase Admin SDK时遭遇「Illegal Firebase credential provided」错误

嗨，我之前也踩过这个坑，来帮你搞定这个问题！

问题根源 #

你当前的代码直接把字典传给了firebase_admin.initialize_app()，但Firebase Admin SDK要求必须传入有效的Credential实例，而不是普通字典。另外还有个常见的隐形坑：.env文件里的PRIVATE_KEY因为包含换行符，读取后格式会错乱，这也会导致凭证验证失败。

分步解决方案 #

1. 修正.env文件中的PRIVATE_KEY格式

Firebase下载的私钥JSON里的private_key是带换行的，在.env里要把换行替换成\n，示例如下：

TYPE=service_account
PROJECT_ID=your-project-id
CLIENT_EMAIL=your-service-account-email@your-project-id.iam.gserviceaccount.com
PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...\n-----END PRIVATE KEY-----"
# 其他变量按实际值填写完整

提示：如果你的.env解析器支持多行字符串，也可以用三个引号包裹私钥，但用\n替换换行是兼容性最好的通用方案。

2. 用Credential实例初始化SDK

修改你的代码，先通过credentials.Certificate()创建标准凭证对象，再传入初始化方法，同时处理私钥的换行符：

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

load_dotenv()  # 加载.env环境变量

# 构建凭证对象，重点处理私钥的换行符还原
cred = credentials.Certificate({
    "type": os.getenv("TYPE"),
    "project_id": os.getenv("PROJECT_ID"),
    "client_email": os.getenv("CLIENT_EMAIL"),
    "private_key": os.getenv("PRIVATE_KEY").replace('\\n', '\n'),  # 把转义的\\n还原成真实换行
    "client_id": os.getenv("CLIENT_ID"),
    "private_key_id": os.getenv("PRIVATE_KEY_ID"),
    "auth_uri": os.getenv("AUTH_URI"),
    "token_uri": os.getenv("TOKEN_URI"),
    "auth_provider_x509_cert_url": os.getenv("AUTH_PROVIDER_X509_CERT_URL"),
    "client_x509_cert_url": os.getenv("CLIENT_X509_CERT_URL"),
})

# 用凭证对象初始化Firebase App
firebase_admin.initialize_app(cred)

3. 验证变量是否正确加载

可以临时添加打印语句，确认所有环境变量都被正确读取，比如：

print("PRIVATE_KEY片段:", os.getenv("PRIVATE_KEY")[:50])
print("CLIENT_EMAIL:", os.getenv("CLIENT_EMAIL"))

如果某个变量为空，检查.env文件的变量名拼写是否正确，或者load_dotenv()的路径是否正确（如果.env不在当前目录，需要指定路径：load_dotenv(dotenv_path="/path/to/your/.env")）。

总结 #

这个错误主要是两个原因：一是没有用Credential实例而是直接传字典，二是私钥的换行符在.env中没有正确处理。按照上面的步骤修改后，应该就能成功初始化Firebase Admin SDK了！

内容的提问来源于stack exchange，提问作者B. Mohammad