在 FastAPI 中，传入一个字符串参数可以通过路径参数、查询参数或请求体来实现。以下是三种常见的实现方式及其代码示例。 --- ### 方法 1：通过路径参数传递字符串 ```python from fastapi import FastAPI app = FastAPI() # 定义路径参数 @app.get("/items/{item_id}") async def read_item(item_id: str): return {"item_id": item_id} ``` **测试 URL**: `http://127.0.0.1:8000/items/foo` 返回结果： ```json { "item_id": "foo" } ``` --- ### 方法 2：通过查询参数传递字符串 ```python from fastapi import FastAPI app = FastAPI() # 定义查询参数 @app.get("/items/") async def read_item(item_id: str): return {"item_id": item_id} ``` **测试 URL**: `http://127.0.0.1:8000/items/?item_id=foo` 返回结果： ```json { "item_id": "foo" } ``` --- ### 方法 3：通过请求体传递字符串 如果需要通过 POST 请求的 JSON 请求体传递字符串，可以使用 Pydantic 模型来定义参数。 ```python from fastapi import FastAPI from pydantic import BaseModel app = FastAPI() # 定义 Pydantic 模型 class Item(BaseModel): item_id: str # 定义 POST 路由 @app.post("/items/") async def create_item(item: Item): return {"item_id": item.item_id} ``` **测试命令**（使用 `curl`）： ```bash curl -X POST http://127.0.0.1:8000/items/ \ -H "Content-Type: application/json" \ -d '{"item_id": "foo"}' ``` 返回结果： ```json { "item_id": "foo" } ``` --- ### 上述代码解释 1. **路径参数**： - 在路径中直接定义参数 `{item_id}`，FastAPI 会自动解析并将其作为函数参数传递。 - 适用于参数是 URL 的一部分的场景。 2. **查询参数**： - 查询参数通过 URL 的 `?key=value` 形式传递。 - 适用于参数是可选或附加信息的场景。 3. **请求体**： - 使用 Pydantic 模型定义请求体结构。 - 适用于复杂数据结构或需要类型验证的场景。 --- ### 注意事项 1. **路径参数与查询参数的区别**： - 路径参数是 URL 的一部分，通常用于标识资源。 - 查询参数是附加在 URL 后面的信息，通常用于过滤或分页。 2. **类型提示**： - FastAPI 使用 Python 的类型提示（如 `str`）来自动验证参数类型。 - 如果传递的参数类型不匹配，FastAPI 会返回 422 错误（Unprocessable Entity）。 3. **默认值**： - 查询参数可以设置默认值。例如： ```python @app.get("/items/") async def read_item(item_id: str = "default"): return {"item_id": item_id} ``` ---