Flask会话购物车添加商品时KeyError异常排查求助

我正在搭建一个简易网店，未注册用户的购物车商品先存储在Flask Session字典中（注册后存入SQL），但错误处理未达预期，无法定位原因。

预期逻辑：

• 首次添加商品时，"basket"键不存在，应触发两次KeyError（对应打印hit3）
• 首次添加某类商品时，对应product_id键不存在，应触发一次KeyError（对应打印hit2）
• 重复添加同类商品时，数量应加1（对应打印hit1）

添加print语句跟踪执行路径后发现，即使重复添加同类商品，仍会触发第一个KeyError，请问原因是什么？

代码如下：

@app.route("/product_to_basket/<product_id>")
def add_product_basket(product_id):
    try:
        session["basket"][product_id] += 1
        print("hit1")
    except KeyError:
        try:
            session["basket"].update({product_id: 1})
            print("hit2")
        except KeyError:
            session.update({"basket": {product_id: 1}})
            print("hit3")

原因分析与解决方案 #

核心原因 #

Flask的session是代理对象，并非普通Python字典。当你修改session["basket"]内部的嵌套字典（比如执行session["basket"][product_id] +=1或update操作）时，session无法自动感知到嵌套字典的内部变化，导致修改后的内容不会被持久化到会话中。后续请求时，session["basket"]要么不存在，要么没有对应的product_id，所以重复添加时仍会触发KeyError。

解决方案 #

方案一：显式标记会话已修改

每次修改嵌套字典后，手动设置session.modified = True，告诉Flask会话内容已更新，需要保存。

修改后的代码：

@app.route("/product_to_basket/<product_id>")
def add_product_basket(product_id):
    try:
        session["basket"][product_id] += 1
        print("hit1")
        session.modified = True
    except KeyError:
        try:
            session["basket"].update({product_id: 1})
            print("hit2")
            session.modified = True
        except KeyError:
            session.update({"basket": {product_id: 1}})
            print("hit3")

注：直接修改session顶层键（比如session.update({"basket": ...})）时，Flask会自动标记会话修改，所以hit3分支无需额外设置。

方案二：重新赋值嵌套字典（更简洁）

先取出购物车字典，修改后重新赋值给session["basket"]，通过顶层赋值触发Flask的自动检测，避免嵌套try-except的复杂结构。

修改后的代码：

@app.route("/product_to_basket/<product_id>")
def add_product_basket(product_id):
    # 先获取现有购物车，不存在则返回空字典
    basket = session.get("basket", {})
    if product_id in basket:
        basket[product_id] += 1
        print("hit1")
    else:
        basket[product_id] = 1
        print("hit2" if "basket" in session else "hit3")
    # 重新赋值触发会话更新
    session["basket"] = basket

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