Bottle框架下多用户上传同名文件是否会覆盖？如何规避命名冲突？

首先直接给你答案：是的，如果直接使用用户上传的原文件名保存，完全会出现同名文件被覆盖的情况。比如两个用户同时上传a.jpg，假设你代码里直接把文件保存到某个固定目录下的a.jpg，后完成写入的文件会直接覆盖先写入的——操作系统里同一个路径下不允许存在两个同名文件，并发场景下这种覆盖几乎是必然会发生的。

接下来给你几个实用的解决策略，都是实际项目里常用的：

1. 生成全局唯一的文件名（最推荐） #

利用Python的uuid模块生成唯一标识符，再拼接原文件的扩展名，这样每个上传的文件都有独一无二的名字，从根源上避免冲突。

修改你的代码示例：

import uuid
import os
from flask import Flask, request
import io

@app.route('/test', methods=['POST'])
def index_view():
    image = request.files.get('image')
    if not image:
        return "No file uploaded", 400
    
    # 获取原文件的扩展名（比如.jpg）
    ext = os.path.splitext(image.filename)[1]
    # 生成唯一文件名
    unique_filename = f"{uuid.uuid4().hex}{ext}"
    # 保存文件到指定目录，比如uploads文件夹
    save_path = os.path.join('uploads', unique_filename)
    image.save(save_path)
    
    # 后续处理img的逻辑
    img = io.imread(image.file)
    # ... 其他代码
    return "File uploaded successfully"

uuid.uuid4()生成的是随机的唯一字符串，几乎不可能重复，非常适合这种场景。

2. 按用户或时间维度拆分存储目录 #

如果想要保留原文件名，可以通过创建子目录来隔离不同的上传场景：

• 按用户拆分：给每个注册用户创建单独的文件夹，文件保存在对应用户的目录下，这样即使文件名相同，目录不同也不会冲突。
• 按时间拆分：比如按年/月/日创建层级目录，每天的上传文件都存在当天的文件夹里，降低同名冲突的概率。

示例代码（按用户ID拆分）：

import os
from flask import Flask, request
import io

@app.route('/test', methods=['POST'])
def index_view():
    image = request.files.get('image')
    user_id = request.form.get('user_id')  # 假设前端传了用户ID
    if not image or not user_id:
        return "Missing file or user ID", 400
    
    # 创建用户专属目录
    user_dir = os.path.join('uploads', user_id)
    os.makedirs(user_dir, exist_ok=True)  # 目录不存在就创建
    
    # 直接用原文件名保存，因为在用户专属目录里，冲突概率极低
    save_path = os.path.join(user_dir, image.filename)
    image.save(save_path)
    
    # 后续处理
    img = io.imread(image.file)
    # ...
    return "File uploaded successfully"

3. 检测文件名并添加增量后缀 #

如果一定要保留原文件名的核心部分，可以检查目标路径下是否已存在同名文件，如果存在就添加数字后缀（比如a.jpg→a_1.jpg→a_2.jpg）。

示例代码：

import os
from flask import Flask, request
import io

def get_unique_filename(base_dir, filename):
    name, ext = os.path.splitext(filename)
    counter = 1
    while True:
        new_filename = f"{name}_{counter}{ext}" if counter > 1 else filename
        save_path = os.path.join(base_dir, new_filename)
        if not os.path.exists(save_path):
            return new_filename
        counter += 1

@app.route('/test', methods=['POST'])
def index_view():
    image = request.files.get('image')
    if not image:
        return "No file uploaded", 400
    
    base_dir = 'uploads'
    os.makedirs(base_dir, exist_ok=True)
    unique_filename = get_unique_filename(base_dir, image.filename)
    save_path = os.path.join(base_dir, unique_filename)
    image.save(save_path)
    
    # 后续处理
    img = io.imread(image.file)
    # ...
    return "File uploaded successfully"

不过这种方法在高并发场景下可能会有竞态条件（比如两个请求同时检测到文件不存在，然后都去写入），所以最好配合文件系统的原子操作或者加锁来避免。

总结一下，最省心的还是第一种生成唯一文件名的方式，实现简单且能彻底解决冲突问题。

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