如何在FastAPI同一API端点同时使用PUT和POST实现用户增改？

FastAPI允许同一API端点绑定多个HTTP方法，你可以根据需求让PUT和POST都执行"存在则更新、不存在则创建"的Upsert逻辑，也可以结合RESTful语义微调（但你的需求下统一逻辑完全没问题）。

实现步骤 #

• 先定义接收请求数据的Pydantic模型，用于校验输入：

from pydantic import BaseModel

class UserRequest(BaseModel):
    user_name: str
    user_details: dict  # 可根据实际业务替换为更具体的字段结构

• 为同一个路径分别绑定PUT和POST方法，在路由函数中实现核心逻辑：

from fastapi import FastAPI, Depends
from sqlalchemy.orm import Session
# 替换成你的数据库会话和用户模型导入
from your_db_utils import get_db_session, UserModel

app = FastAPI()

@app.put("/users")
@app.post("/users")
def upsert_user(user_data: UserRequest, db: Session = Depends(get_db_session)):
    # 查询数据库中是否存在该用户名
    existing_user = db.query(UserModel).filter(UserModel.user_name == user_data.user_name).first()
    
    if existing_user:
        # 存在则更新用户详情
        existing_user.user_details = user_data.user_details
    else:
        # 不存在则创建新用户
        new_user = UserModel(user_name=user_data.user_name, user_details=user_data.user_details)
        db.add(new_user)
    
    db.commit()
    db.refresh(existing_user if existing_user else new_user)
    return existing_user if existing_user else new_user

额外说明 #

从RESTful设计角度：

• POST更偏向"创建新资源"，但业界也普遍接受用它做Upsert
• PUT本身就带有"更新或创建（已知资源标识时）"的语义，和你的需求更契合

如果需要严格遵循规范，也可以让POST仅负责创建（用户名存在则返回错误），PUT负责Upsert，但技术上FastAPI完全支持同一端点绑定多方法并执行相同逻辑。

内容的提问来源于stack exchange，提问作者madhu mitha