python上传文件到服务器-凌峰创科服务平台

在Python中实现文件上传到服务器的功能是许多Web应用和自动化脚本中的常见需求，无论是用户通过网页界面提交文件，还是程序自动将日志、数据文件等传输到远程服务器，Python都提供了多种灵活且高效的解决方案，本文将详细介绍几种主流的文件上传方法，包括使用HTTP POST请求、FTP协议、SFTP协议以及云存储服务，并附上代码示例和注意事项,帮助开发者根据实际场景选择最合适的技术方案。

（图片来源网络，侵删）

使用HTTP POST请求上传文件

HTTP协议是最常用的文件上传方式，尤其适用于Web应用场景，Python的requests库简化了HTTP请求的发送过程，支持multipart/form-data格式，这是文件上传的标准格式,以下是实现步骤：

安装requests库：如果尚未安装，可通过pip install requests命令完成。
编写上传脚本：假设服务器端有一个接收文件的接口（如http://example.com/upload），客户端代码如下：
```
import requests
```

file_path = 'example.txt' # 本地文件路径 url = 'http://example.com/upload'

with open(file_path, 'rb') as file: files = {'file': (file_path, file)} # 'file'是服务器端接收的表单字段名 response = requests.post(url, files=files)

if response.status_code == 200: print('文件上传成功:', response.text) else: print('上传失败:', response.status_code)

（图片来源网络，侵删）

**关键点说明**：
- `files`参数是一个字典，键是表单字段名，值是一个元组，包含文件名和文件对象。
- 服务器端需配置好接收文件的接口（如使用Flask、Django等框架）。
- 支持同时上传多个文件，只需在`files`字典中添加多个键值对。
**优点**：简单易用，适合Web应用；支持进度显示（需结合`tqdm`库）。  
**缺点**：依赖服务器端接口；大文件上传可能需要分块处理。
### 二、使用FTP协议上传文件
FTP（文件传输协议）是传统的文件传输方式，适用于服务器支持FTP的场景，Python内置的`ftplib`模块提供了FTP操作功能，无需额外安装。
**代码示例**：
```python
from ftplib import FTP
def upload_ftp(local_file, remote_file, ftp_host, ftp_user, ftp_pass):
    ftp = FTP(ftp_host)
    ftp.login(ftp_user, ftp_pass)
    with open(local_file, 'rb') as file:
        ftp.storbinary(f'STOR {remote_file}', file)
    ftp.quit()
    print('FTP上传完成')
# 调用示例
upload_ftp('local_data.csv', 'remote_data.csv', 'ftp.example.com', 'user', 'password')

关键点说明：

storbinary方法用于上传二进制文件，storlines适用于文本文件。
需要确保FTP服务器配置允许上传,并正确设置目录权限。
可通过ftp.cwd()切换远程目录。

优点：兼容性强，适合批量文件传输；支持主动/被动模式。
缺点：FTP协议不安全（密码明文传输），建议使用FTPS（FTP over SSL）替代。

使用SFTP协议上传文件

SFTP（SSH文件传输协议）基于SSH协议，安全性高于FTP，是现代服务器的主流选择，Python的paramiko库实现了SSHv2协议,支持SFTP操作。

安装paramiko：pip install paramiko
代码示例：

（图片来源网络，侵删）

import paramiko
def upload_sftp(local_file, remote_file, host, port, username, password):
    transport = paramiko.Transport((host, port))
    transport.connect(username=username, password=password)
    sftp = paramiko.SFTPClient.from_transport(transport)
    sftp.put(local_file, remote_file)
    sftp.close()
    transport.close()
    print('SFTP上传完成')
# 调用示例
upload_sftp('report.pdf', '/remote/path/report.pdf', 'sftp.example.com', 22, 'user', 'pass')

关键点说明：

支持密钥认证（比密码更安全），可通过transport.connect(username=username, pkey=key)实现。
sftp.put()上传文件，get()下载文件。
可通过sftp.mkdir()创建远程目录。

优点：加密传输，安全性高；支持SSH所有功能（如端口转发）。
缺点：需要服务器开启SSH服务；paramiko库依赖OpenSSL。

使用云存储服务上传文件

对于现代应用，直接上传到云存储（如AWS S3、阿里云OSS）是更高效的选择，Python官方提供了各云厂商的SDK，以AWS S3为例：

安装boto3：pip install boto3
代码示例：

import boto3
def upload_s3(file_name, bucket, object_name=None):
    s3 = boto3.client('s3')
    if object_name is None:
        object_name = file_name
    s3.upload_file(file_name, bucket, object_name)
    print(f'S3上传完成: s3://{bucket}/{object_name}')
# 调用示例
upload_s3('data.json', 'my-bucket', 'uploads/data.json')

关键点说明：

需配置AWS凭证（通过环境变量、配置文件或IAM角色）。
支持分块上传大文件（s3.upload_fileobj()方法）。
可结合boto3的权限管理实现精细控制。

优点：高可用性、可扩展性；与云服务生态无缝集成。
缺点：依赖云服务商；可能产生额外费用。

性能优化与错误处理

无论采用哪种方式,都需要考虑以下优化和错误处理：

大文件分块上传：对于超过100MB的文件，建议分块上传（如HTTP的chunked encoding或S3的MultipartUpload）。
断点续传：记录已上传的字节位置,中断后可从断点继续。

异常捕获：使用try-except处理网络错误、权限错误等。

try:
    requests.post(url, files=files, timeout=30)
except requests.exceptions.RequestException as e:
    print(f'请求失败: {e}')

进度显示：使用tqdm库显示上传进度：

from tqdm import tqdm
with open(file_path, 'rb') as file, tqdm(unit='B', unit_scale=True, unit_divisor=1024) as progress_bar:
    files = {'file': (file_path, file)}
    response = requests.post(url, files=files)

不同上传方式对比

方式	适用场景	安全性	依赖环境	复杂度
HTTP POST	Web应用、用户上传	中（需HTTPS）	服务器支持HTTP接口	低
FTP	传统服务器、批量文件	低	FTP服务器	中
SFTP	安全传输、Linux服务器	高	SSH服务、paramiko库	中
云存储（S3等）	现代应用、高并发需求	高	云服务商账号、SDK	中