Docker部署Heroku Django应用：如何存储Google API凭证到Config Vars并本地访问？

一、可行方案：用Heroku Config Vars存储JSON凭证 #

完全可以把Firebase服务账号的JSON内容存入Heroku的Config Vars，既避免敏感文件上传到版本库，又符合Heroku无状态部署的要求。

二、Heroku端配置步骤 #

• 登录Heroku控制台，找到目标应用，进入「Settings」标签页
• 找到「Config Vars」区域，点击「Reveal Config Vars」
• 添加新环境变量：键设为FIREBASE_SERVICE_ACCOUNT，值粘贴完整的Firebase服务账号JSON内容（注意删除JSON末尾多余的逗号，保证格式合法）

三、修改Django代码读取环境变量 #

替换原有的文件读取逻辑，改为优先从环境变量获取凭证，本地环境自动降级到文件读取：

import os
import json
from firebase_admin import credentials, initialize_app

# 尝试从环境变量获取Firebase配置
firebase_config_str = os.environ.get('FIREBASE_SERVICE_ACCOUNT')
if firebase_config_str:
    # 将JSON字符串解析为字典
    firebase_config = json.loads(firebase_config_str)
    # 修复private_key的换行转义问题（环境变量中换行会被转为\\n）
    firebase_config['private_key'] = firebase_config['private_key'].replace('\\n', '\n')
    cred = credentials.Certificate(firebase_config)
else:
    # 本地环境 fallback 到JSON文件
    cred = credentials.Certificate("google_api_data.json")

initialize_app(cred)

四、本地环境访问凭证的两种方式 #

方式1：保留本地JSON文件（无需额外配置） #

继续将google_api_data.json放在manage.py同目录，保持.gitignore配置即可。代码会自动在环境变量不存在时读取本地文件，完全兼容原有开发流程。

方式2：本地使用环境变量（和生产环境一致） #

如果想让本地和生产环境配置统一，推荐用.env文件管理：

1. 安装依赖包：pip install python-dotenv
2. 在项目根目录创建.env文件，写入：

   FIREBASE_SERVICE_ACCOUNT={"type": "service_account", "project_id": "xyz", "private_key_id": "xyz", ...}
   

   （粘贴完整的JSON内容即可，无需转义双引号）
3. 在Django初始化Firebase的文件开头添加：

   from dotenv import load_dotenv
   load_dotenv()
   

4. 将.env加入.gitignore，防止敏感信息泄露

五、关键注意事项 #

• 粘贴JSON到Heroku Config Vars时，务必检查格式：删除末尾键值对后的多余逗号，避免JSON解析失败
• 环境变量中的private_key会自动转义换行符为\\n，代码中必须替换回真实换行\n，否则Firebase会验证失败
• 本地测试时，优先用环境变量方式验证配置，确认无误后再部署到Heroku

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