为何Boto3下载文件会变更文件名？Docker容器异常排查

问题场景 #

本地手动运行项目时一切正常，但部署到Docker容器后，Boto3下载的文件扩展名出现异常变更，文件名后会随机添加类似.50Cansdf的后缀。

相关代码 #

下载文件函数：

def download_file(filename):
    try:
        s3 = boto3.client('s3')
        s3.download_file(os.getenv('BUCKET_NAME'), filename, os.getenv('LOCAL_FILE_NAME'))
        return True, "File downloaded successfully"
    except Exception as e:
         return False, str(e)

本地文件路径配置：

LOCAL_FILE_NAME = tmp/file_to_process.pdf

异常表现 #

下载后的文件名变为：

tmp/file_to_process.pdf.50Cansdf
tmp/file_to_process.pdf.B0CnBB1d
tmp/file_to_process.pdf.A0CaDB1d   

核心原因及排查方向 #

• 临时文件重命名失败：Boto3的s3.download_file默认采用原子写入策略——先下载到带随机后缀的临时文件，下载完成后再重命名为目标文件名。如果Docker容器内tmp目录权限不足，或者进程没有文件重命名权限，就会导致临时文件无法被重命名，最终保留了随机后缀。
• 文件系统兼容性问题：若容器的tmp目录挂载自宿主机的网络文件系统（如NFS）或不支持原子操作的分区，重命名操作会失败，临时文件无法替换为目标文件。
• 并发操作冲突：如果多个进程/线程同时调用该下载函数，目标文件被占用，Boto3无法完成重命名步骤，临时文件残留。
• 环境变量异常：排查容器内LOCAL_FILE_NAME环境变量是否被意外篡改，比如启动容器时注入了错误的路径值，但从异常文件名格式来看，这种可能性较低。

内容的提问来源于stack exchange，提问作者Carlos Daniel Ospina Salazar