FastAPI中抛出HTTPException始终返回200 [OK]问题求助

你的问题核心在于数据库操作的写法错误（若使用psycopg2），导致代码逻辑未按预期触发HTTPException，最终意外返回200状态码。

错误点排查 #

你当前代码里的链式调用cur.execute(...).fetchone()，在psycopg2环境下会直接抛出AttributeError——因为cur.execute()返回None，无法调用fetchone()方法。此时异常会绕过你的if deleted_post == None判断：若没有额外异常捕获，FastAPI会返回500错误；如果存在全局异常处理吞掉了该错误，就可能返回200。

即便你用的是支持链式调用的psycopg3，这种写法也不推荐，可读性和维护性较差。

修正方案 #

1. 拆分数据库操作语句 #

将execute和fetchone分开执行，确保能正确获取删除结果：

from fastapi import FastAPI, status, HTTPException
import psycopg2  # 或 psycopg

@app.delete("/posts/{id}")
def delete_post(id: int):
    try:
        with psycopg2.connect("host=localhost dbname=fastapi user=postgres password=postgres") as conn:
            with conn.cursor() as cur:
                # 拆分execute与fetchone操作
                cur.execute("DELETE FROM posts WHERE id = %s RETURNING *", [id])
                deleted_post = cur.fetchone()
                conn.commit()
                
                if deleted_post is None:  # 推荐用is None替代==None，更规范高效
                    raise HTTPException(
                        status_code=status.HTTP_404_NOT_FOUND,
                        detail=f"Post with id: {id} was not found."
                    )
                
                return {"message": "Post deleted successfully", "data": deleted_post}
    except psycopg2.Error as e:
        # 捕获数据库异常，返回明确的500错误信息
        raise HTTPException(
            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
            detail=f"Database error: {str(e)}"
        )

2. 额外优化建议 #

• 规范空值判断：Python中判断对象是否为None时，is None比== None更高效且符合编码规范。
• 添加数据库异常捕获：避免因连接失败、SQL语法错误等导致返回无意义的状态码，提供更清晰的错误提示。
• 符合RESTful规范：若不需要返回删除的帖子数据，可将装饰器改为@app.delete("/posts/{id}", status_code=status.HTTP_204_NO_CONTENT)，204状态码表示请求成功但无返回内容。

验证方法 #

1. 确认测试用的ID不存在于数据库中。
2. 调用删除接口，检查是否返回404状态码及对应错误信息。
3. 测试存在的ID，确认返回200（或204）及正确的响应内容。

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