### ### 文件上传的基本原理 文件上传的核心是通过 HTTP 的 POST 请求将文件数据发送到服务器。在 Python 中，使用 `requests` 库实现文件上传的步骤如下：打开本地文件，以二进制模式读取文件内容；构建一个字典，将文件对象作为字典的值，键通常为服务器端接收文件的字段名；使用 `requests.post()` 方法发送请求，将文件字典作为 `files` 参数传递 [^3]。 ### ### 单个文件上传 以下是一个简单的示例，展示如何使用 `requests` 库上传单个文件： ```python import requests # 定义服务器的 URL url = 'http://example.com/upload' # 打开本地文件 with open('example.txt', 'rb') as file: # 构建文件字典 files = {'file': file} # 发送 POST 请求 response = requests.post(url, files=files) # 检查响应状态码 if response.status_code == 200: print('文件上传成功') else: print(f'文件上传失败，状态码：{response.status_code}') ``` ### ### 多个文件上传 在 `requests` 库中，上传多个文件的方法非常简单。可以使用 `files` 参数来上传多个文件，`files` 参数接受一个列表，列表中的每个元素是一个元组，元组的第一个元素是字段名，第二个元素是一个元组，包含文件名、文件对象和 MIME 类型 [^2]。 ```python import requests url = 'http://httpbin.org/post' file_list = [ ('file1', ('filename1.png', open('filepath1.png', 'rb'), 'image/png')), ('file2', ('filename2.png', open('filepath2.png', 'rb'), 'image/png')) ] response = requests.post(url, files=file_list) print(response.text) ``` ### ### 使用 MultipartEncoder 上传文件 对于更复杂的文件上传需求，可以使用 `requests-toolbelt` 第三方库中的 `MultipartEncoder` 类来处理 `multipart/form-data` 编码： ```python from requests_toolbelt import MultipartEncoder import requests m = MultipartEncoder( fields={ 'field0': 'value', 'field1': 'value', 'field2': ('filename', open('file.py', 'rb'), 'text/plain') } ) r = requests.post('http://httpbin.org/post', data=m, headers={'Content-Type': m.content_type}) print(r.text) ``` ### ### 错误处理 在进行文件上传时，网络请求可能会遇到各种问题，例如超时、HTTP 错误等。为了提高程序的健壮性，可以在请求过程中加入错误处理机制： ```python import requests try: response = requests.get('http://example.com/upload', timeout=10) response.raise_for_status() print(response.json()) except requests.exceptions.Timeout: print("请求超时") except requests.exceptions.HTTPError as err: print(f"HTTP 错误: {err.response.status_code}") except requests.exceptions.RequestException as err: print(f"网络错误: {err}") ``` ###