### 如何在 FastAPI 中通过 Token 提交 Form-Data 在 FastAPI 中，可以通过 `Depends` 和 `Form` 来处理带 Token 验证的表单数据提交。以下是具体实现方法： #### 实现步骤说明 为了支持基于 Token 的身份验证以及接收 `multipart/form-data` 类型的数据，可以利用 FastAPI 的依赖注入机制来解析和校验 Token，并使用 `File` 或 `Form` 参数来获取上传的文件或其他字段。 以下是一个完整的示例代码[^2]： ```python from fastapi import FastAPI, Depends, HTTPException, File, Form, UploadFile from pydantic import BaseModel from typing import Optional app = FastAPI() # 假设这是一个简单的令牌验证函数 def verify_token(token: str) -> bool: """模拟Token验证逻辑""" valid_tokens = ["valid_token_123"] # 存储有效的Tokens if token not in valid_tokens: raise HTTPException(status_code=401, detail="Invalid or expired token") return True class FormDataModel(BaseModel): field_name: str file_content: bytes @app.post("/submit_form/") async def submit_form( token: str = Form(...), text_field: str = Form(...), image_file: UploadFile = File(...) ): """ 接收一个包含 Token、文本字段和图片文件的表单。 """ # 调用 Token 验证函数 verified = verify_token(token) if verified: content_type = image_file.content_type filename = image_file.filename file_size = len(await image_file.read()) response_data = { "text_field": text_field, "file_details": { "filename": filename, "content_type": content_type, "size_in_bytes": file_size } } return {"status": "success", "data": response_data} return {"status": "failure", "message": "Unauthorized"} ``` #### 关键点解释 1. **Token 验证**: 在上面的例子中定义了一个名为 `verify_token` 的辅助函数用于验证传入的 Token 是否有效。如果无效，则抛出 `HTTPException(401)` 表明未授权访问[^2]。 2. **参数声明**: - 使用 `Form(...)` 获取普通的字符串形式字段 (如用户名密码等). - 对于二进制大对象比如图片视频则采用 `UploadFile`. 3. **错误处理**: 如果用户的请求缺少必要的字段或者提供了非法的内容类型，FastAPI 自动返回相应的错误响应给客户端. --- ### 注意事项 - 上述例子假设所有的请求都携带合法 Tokens 并且这些 tokens 已经被预置好. - 生产环境中建议加密传输敏感信息并通过 HTTPS 协议保障安全性.