直接替换DEFAULT_FILE_STORAGE上传失败，根本原因是自定义存储类未重写__init__方法导致必要参数（如bucket_name）未初始化；实操须继承Storage、显式定义__init__并校验参数，且settings中必须用字符串路径引用类。
为什么直接替换DEFAULT_FILE_STORAGE会上传失败？
多数人改完settings.py里的DEFAULT_FILE_STORAGE指向自定义类后，调用model_instance.file_field.save()就抛AttributeError: 'OSSStorage' object has no attribute 'bucket_name'——根本原因是Django的Storage基类不做参数校验，但你的自定义类没实现__init__或漏传必要参数，导致实例化时字段未初始化。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 继承
django.core.files.storage.Storage，**必须重写__init__**，显式接收并保存所有依赖参数（如access_key、bucket_name、endpoint） - 避免在
__init__里做耗时操作（如连接OSS客户端），放到首次调用_get_client()时懒加载 - 检查
settings.py中是否用字符串路径引用类（如'myapp.storage.OSSStorage'），而非直接导入的类对象——Django只接受字符串
如何让save()和url()适配OSS的签名URL逻辑？
OSS返回的文件URL带临时签名，而Django默认url()只拼接MEDIA_URL前缀。若不干预，前端拿到的是无效链接。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 重写
OSSStorage.url(self, name)方法：用OSS SDK的sign_url('GET', bucket, key, expires)生成带签名的URL -
save()内部调用_save()时，确保name参数不含本地路径（如./uploads/xxx.jpg），OSS要求key是纯路径（如uploads/xxx.jpg），可用os.path.basename(name)或posixpath标准化 - 如果OSS Bucket开启静态网站托管，且允许匿名读取，可跳过签名直接返回
https://bucket.oss-region.aliyuncs.com/{name}，但生产环境慎用
上传大文件时FileUploadError怎么定位？
常见现象是request.FILES['file']传入default_storage.save()后卡住或报ConnectionResetError，本质是OSS SDK默认分片上传阈值（100MB）与Django内存缓冲冲突。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 在自定义Storage的
_save()中，对大于10MB的文件启用分片上传：bucket.put_object_from_file(key, local_path)（SDK自动处理） - 确保
FILE_UPLOAD_MAX_MEMORY_SIZE（默认2.5MB）足够小，避免Django把整个文件载入内存；同时设DATA_UPLOAD_MAX_MEMORY_SIZE匹配业务需求 - 调试时打印
file.size和file.chunks()行为：流式上传需迭代file.chunks(chunk_size=8192)，而非直接读file.read()
Django Admin上传文件后，数据库存的upload_to路径为何和OSS实际key不一致？
比如模型字段定义models.FileField(upload_to='user/%Y/%m/')，Admin保存后数据库记录user/2024/06/filename.jpg，但OSS里实际存为user/2024/06/xxx-filename.jpg（带哈希前缀）——这是为防重名做的重命名，但Django没同步更新数据库字段。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 在自定义Storage的
_save()返回值必须是**最终实际存储的key**（不是原始name），Django靠这个值更新数据库字段 - 若需保留原始文件名，用
os.path.join(upload_to, original_filename)构造key；若要加哈希前缀，生成后return该完整路径 - 避免在
upload_to里用datetime.now()等动态函数——Django在模型实例化时就计算了upload_to，非上传时刻
oss-cn-hangzhou.aliyuncs.com，但SDK初始化时若填成https://oss-cn-hangzhou.aliyuncs.com（带https://），会因协议重复导致签名失败。参数校验这种事，得自己在__init__里手动做。 
