### FastAPI 使用 UploadFile 实现文件上传 在 FastAPI 中，`UploadFile` 是专门用于处理文件上传的功能类。通过 `UploadFile` 可以轻松获取并操作上传的文件内容及其元信息。以下是其实现方法和具体示例。 #### 方法说明 1. **导入必要模块** 需要从 `fastapi` 导入 `UploadFile` 和 `File` 模块。 2. **定义路由** 定义一个 POST 路由来接收文件上传请求。可以通过设置参数类型为 `UploadFile` 来指定该参数是一个文件输入字段。 3. **异步读取文件内容** 使用 `await file.read()` 异步读取文件的内容。如果需要保存文件到本地或其他存储位置，则可以在读取后执行相应的逻辑。 4. **返回响应** 根据需求返回文件的相关信息，例如文件名、大小、类型等。 --- #### 示例代码 以下是一个完整的实现示例： ```python from fastapi import FastAPI, File, UploadFile import shutil # 用于文件复制 app = FastAPI() @app.post("/upload/") async def upload_file(file: UploadFile = File(...)): """ 接收单个文件上传，并返回其基本信息。 """ # 获取文件名称 filename = file.filename # 计算文件大小（单位：字节） contents = await file.read() size_in_bytes = len(contents) # 如果需要保存文件到本地 with open(f"./{filename}", "wb") as buffer: shutil.copyfileobj(file.file, buffer) return { "filename": filename, "size_in_bytes": size_in_bytes, "content_type": file.content_type } ``` 此代码实现了基本的文件上传功能，能够接收文件并将其保存到当前目录下[^1]。 对于多个文件上传的情况，可以修改参数类型为列表形式： ```python from typing import List @app.post("/upload/multiple/") async def upload_multiple_files(files: List[UploadFile] = File(...)): """ 接收多个文件上传，并返回它们的基本信息。 """ uploaded_files = [] for file in files: contents = await file.read() uploaded_files.append({ "filename": file.filename, "size_in_bytes": len(contents), "content_type": file.content_type }) return {"uploaded_files": uploaded_files} ``` 以上代码支持一次性上传多个文件，并逐一处理每个文件的信息[^3]。 --- #### 关键点解析 1. **异步特性** FastAPI 的设计充分利用了 Python 的异步编程能力。因此，在处理文件上传时，推荐使用 `await` 关键字配合异步函数调用，从而提高性能[^4]。 2. **文件保存** 上述示例展示了如何将上传的文件保存到本地磁盘。实际应用中可以根据业务需求调整存储方式，比如上传至云存储服务或数据库二进制字段。 3. **错误处理** 在生产环境中建议增加异常捕获机制，以便更好地应对潜在问题。例如，当文件过大超出内存限制时抛出自定义错误提示。 ---