Django 默认不覆盖同名文件，而是通过 FileSystemStorage 的 get_available_name() 自动重命名（如 report_qx7z2.pdf）；该机制仅在保存时生效，上传阶段需自行处理冲突。
上传文件名重复时 Django 默认怎么处理
Django 的 FileField 和 ImageField 在保存同名文件时，**不会覆盖原文件，而是自动重命名**——这是底层 FileSystemStorage 的默认行为。它在文件名后加下划线和随机字符串（比如 report.pdf → report_qx7z2.pdf），靠 os.path.exists() 检测冲突后循环尝试。
但这个逻辑只作用于「保存到磁盘」那一刻，不介入上传阶段；如果你自己调用 handle_uploaded_file() 或直接操作 request.FILES，就完全绕过了它，冲突由你兜底。
- 常见错误现象：
IOError: [Errno 17] File exists或静默覆盖（手动写入未判重） - 真实场景：用户头像上传、Excel 批量导入、前端直传 OSS 前的文件名预处理
- 注意点：Django 不会帮你清理旧文件，重命名只是避免写失败，历史文件仍留在磁盘上
自定义存储后端里怎么安全重命名
重写 _save() 方法是主流做法，但关键不是“改名字”，而是**确保生成的新名既唯一又可预测、可追溯**。别用 uuid4() 直接拼接——它让 URL 失去语义，调试时无法反查原始文件。
推荐用时间戳 + 原文件名哈希前缀（如 20240521_8a3f_report.pdf），再通过 get_available_name() 让 Django 自动补序号（_1, _2）防极小概率哈希碰撞。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
- 必须调用父类
get_available_name(name)，否则跳过冲突检测逻辑 - 别在
_save()里直接os.path.join()拼路径——Storage 类应保持路径无关性 - 如果用了 CDN 或对象存储，重命名后记得同步更新
url返回值，否则前端拿到的是旧路径
def get_available_name(self, name, max_length=None):
# name 是原始上传名，如 "resume.docx"
base, ext = os.path.splitext(name)
now = datetime.now().strftime("%Y%m%d")
hash_prefix = hashlib.md5(base.encode()).hexdigest()[:4]
new_name = f"{now}_{hash_prefix}_{base}{ext}"
return super().get_available_name(new_name, max_length)为什么不用 upload_to 的 callable 解决重命名
upload_to 参数支持函数，但它只控制「保存路径和文件名前缀」，**不参与冲突检测**。比如返回 "uploads/{uuid4()}/{filename}"，看似唯一，但 Django 仍会用这个完整路径去调 get_available_name()——而此时路径里已含随机段，get_available_name() 检测的是整个路径是否存在，容易误判（尤其并发上传时）。
- 典型坑：
upload_to返回带时间戳的路径，但多请求同一秒到达，生成相同路径 → 写入失败 - 性能影响：每次上传都执行 callable，如果里面含数据库查询或网络请求，会拖慢上传响应
- 正确姿势：把可控的业务标识（如用户 ID、表单 ID）放进
upload_to，把防冲突逻辑交给get_available_name()
重命名后怎么让前端知道真实文件名
HTTP 协议本身不传递服务端保存后的文件名，Content-Disposition 只用于下载响应。所以「上传后返回新名字」这事得靠 API 显式返回。
- 别依赖
instance.file_field.name做前端展示——它包含相对路径，且可能被 Storage 修改过 - 从
instance.file_field.name提取最终文件名要用os.path.basename()，而不是切字符串 - 如果前端需要原始名（比如显示“你上传了 xxx.pdf”），必须单独存字段，如
original_filename = models.CharField(max_length=255)
容易被忽略的一点：重命名逻辑若涉及数据库字段（比如按用户计数生成 report_3.pdf），务必加 select_for_update()，否则高并发下序号会重复。
