Django信号中Cloudinary API初始化失败：必须提供api_key

问题根源 #

信号模块的加载时机可能早于Django配置初始化，导致Cloudinary无法读取settings.py中的API密钥配置；或者信号注册方式有误，引发配置加载异常。

具体解决步骤 #

1. 确保Cloudinary在信号中正确读取配置 #

在signals.py中显式初始化Cloudinary，确保读取settings中的配置：

from django.conf import settings
import cloudinary
from django.db.models.signals import post_save
from django.dispatch import receiver
from .models import UserFiles

# 方式一：手动传入配置参数
cloudinary.config(
    cloud_name=settings.CLOUDINARY_CLOUD_NAME,
    api_key=settings.CLOUDINARY_API_KEY,
    api_secret=settings.CLOUDINARY_API_SECRET
)

# 方式二：自动从settings加载（推荐）
cloudinary.config_from_settings()

@receiver(post_save, sender=UserFiles)
def upload_to_cloudinary(sender, instance, created, **kwargs):
    # 执行你的文件上传逻辑
    # ...

2. 检查信号注册的正确性 #

确保apps.py中的ready()方法正确导入信号模块，且INSTALLED_APPs配置正确：

• 编写AppConfig：

# your_app_name/apps.py
from django.apps import AppConfig

class YourAppConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'your_app_name'

    def ready(self):
        # 导入信号模块触发注册，避免提前加载
        import your_app_name.signals

• 在settings.py的INSTALLED_APPS中替换为AppConfig路径：

INSTALLED_APPS = [
    # ...
    'your_app_name.apps.YourAppConfig',  # 替换原有的'your_app_name'
    # ...
]

3. 延迟Cloudinary初始化到接收器内部 #

如果仍存在加载顺序问题，将Cloudinary初始化移至信号接收器函数内部，确保settings已完全加载：

@receiver(post_save, sender=UserFiles)
def upload_to_cloudinary(sender, instance, created, **kwargs):
    # 仅在触发信号时初始化Cloudinary
    cloudinary.config_from_settings()
    # 执行上传逻辑
    # ...

4. 验证配置项的准确性 #

确认settings.py中的Cloudinary配置项名称正确无误：

# settings.py
CLOUDINARY_CLOUD_NAME = '你的云名称'
CLOUDINARY_API_KEY = '你的API密钥'
CLOUDINARY_API_SECRET = '你的API密钥'

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