Python项目Store API key for requests密钥存储及跨类访问方案咨询

1. 整体技术选型 #

采用「配置集中管理 + 通用请求逻辑封装 + 统一注入」的组合方案，既可以避免密钥散落在各个业务类中，也能减少重复编写鉴权逻辑的冗余代码。

2. 密钥存储方案 #

按照不同运行场景选择存储方式，全程不要硬编码到代码文件中：

• 本地开发场景：用.env文件存储密钥，将该文件加入.gitignore避免提交到代码仓库，文件内容格式为API_BEARER_TOKEN=你的实际密钥值
• 生产部署场景：用部署环境的原生密钥管理能力存储，比如K8s Secret、Docker运行时传入的环境变量、云服务的密钥管理服务，不要使用本地.env文件

3. 具体实现步骤 #

步骤1：集中加载配置 #

单独新建config.py文件负责全局配置读取，用python-dotenv库兼容本地开发和生产环境的配置来源：

# config.py
import os
from dotenv import load_dotenv

# 本地开发会自动读取.env文件，生产环境忽略该文件直接读取系统环境变量
load_dotenv()

API_CONFIG = {
    "bearer_token": os.getenv("API_BEARER_TOKEN"),
    "api_base_url": os.getenv("API_BASE_URL", "https://你的服务默认接口地址")
}

执行pip install python-dotenv安装所需依赖。

步骤2：封装通用请求客户端 #

把带Bearer鉴权的请求逻辑统一封装，所有业务类不需要自行拼接鉴权头：

# utils/api_client.py
import requests
from config import API_CONFIG

class BaseAPIClient:
    def __init__(self):
        self.session = requests.Session()
        # 统一注入鉴权头
        self.session.headers.update({
            "Authorization": f"Bearer {API_CONFIG['bearer_token']}"
        })
    
    def get(self, path, **kwargs):
        return self.session.get(f"{API_CONFIG['api_base_url']}{path}", **kwargs)
    
    def post(self, path, **kwargs):
        return self.session.post(f"{API_CONFIG['api_base_url']}{path}", **kwargs)
    # 其他PUT、DELETE等请求方法按需补充

如果密钥存在过期自动刷新逻辑，也可以把刷新逻辑写到该类中，业务侧完全无感知。

步骤3：业务类调用方式 #

所有需要调用API的业务类直接实例化通用客户端即可，不需要接触密钥内容：

# 任意业务文件，例如services/order_service.py
from utils.api_client import BaseAPIClient

class OrderService:
    def __init__(self):
        self.api_client = BaseAPIClient()
    
    def get_order_detail(self, order_id):
        resp = self.api_client.get(f"/orders/{order_id}")
        resp.raise_for_status()
        return resp.json()

如果你的项目使用了依赖注入框架，可以直接将BaseAPIClient注册为全局单例，通过注入的方式传入业务类，耦合度会更低。

4. 安全注意事项 #

• 不要在日志中打印Authorization请求头或者完整密钥值，避免日志泄露敏感信息
• 生产环境的密钥必须使用专门的密钥管理服务存储，不要明文写在配置文件、启动脚本中

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