Flask-SQLAlchemy嵌套对象PATCH请求报错：AttributeError求解决

问题重现 #

你用Flask-SQLAlchemy、Marshmallow-JSONAPI和Flask-Restless搭建的接口，POST请求可以正常创建包含新作者的图书，但当你用PATCH请求修改图书标题（同时保留原作者的嵌套信息）时，抛出了这个错误：

AttributeError: 'dict' object has no attribute '_sa_instance_state'

为什么会出现这个错误？ #

这个问题的核心原因很明确：

• POST请求时，框架会自动识别嵌套的新资源（这里是作者），帮你创建对应的ORM实例并关联到图书上；
• PATCH请求时，框架不会自动去查找已存在的作者实例，而是直接把你传入的作者字典赋值给Book的author关系字段——但SQLAlchemy的关系字段只接受ORM实例，不接受普通字典，所以就抛出了这个错误。

几个可行的解决方案 #

方案1：按JSONAPI规范，只传递必要的修改内容 #

既然你不需要修改作者信息，完全可以在PATCH请求里去掉嵌套的author结构，只传要修改的标题：

{
  "data": {
    "attributes": {
      "title": "updated title 3"
    },
    "id": "3",
    "type": "book"
  }
}

如果一定要明确关联关系（比如防止意外修改），可以用JSONAPI的relationships字段传递作者ID，而不是完整对象：

{
  "data": {
    "attributes": {
      "title": "updated title 3"
    },
    "relationships": {
      "author": {
        "data": {
          "id": "2",
          "type": "author"
        }
      }
    },
    "id": "3",
    "type": "book"
  }
}

这种方式最简洁，也符合JSONAPI的设计理念，框架会自动找到对应的Author实例完成关联。

方案2：修改Marshmallow Schema，自动处理嵌套实例加载 #

你可以在BookSchema里开启load_instance=True，并添加一个后置加载钩子，把传入的作者数据转换成ORM实例：

from marshmallow import post_load
from sqlalchemy.orm.exc import NoResultFound

class BookSchema(BaseSchema):
    title = fields.Str()
    author_id = fields.Int()
    author = fields.Nested('flask_and_restless.schemas.AuthorSchema', many=False, load_instance=True)
    
    class Meta(BaseSchema.Meta):
        type_ = 'book'
        model = Book
        load_instance=True  # 让Schema加载数据为ORM实例
    
    @post_load
    def resolve_author_instance(self, data, **kwargs):
        # 处理传入的author数据
        if 'author' in data and data['author'] is not None:
            author_obj = data['author']
            # 如果作者对象有id，查询数据库获取实例
            if hasattr(author_obj, 'id'):
                try:
                    data['author'] = Author.query.get(author_obj.id)
                except NoResultFound:
                    # 这里可以根据业务需求处理找不到作者的情况，比如抛出错误
                    pass
        return data

这样当你发送带嵌套作者的PATCH请求时，Marshmallow会自动把作者数据转换成对应的ORM实例，SQLAlchemy就能正常处理了。

方案3：用Flask-Restless预处理钩子手动转换 #

你可以给Book的PATCH接口注册一个预处理钩子，在框架处理请求前把作者字典换成ORM实例：

def book_patch_preprocessor(instance_id, data):
    # 检查请求中是否包含author嵌套结构
    if 'author' in data.get('attributes', {}):
        author_data = data['attributes']['author']['data']
        if 'id' in author_data:
            # 查询获取已存在的Author实例
            author = Author.query.get(author_data['id'])
            if author:
                # 把字典替换成ORM实例
                data['attributes']['author'] = author
            else:
                # 处理作者不存在的情况，比如抛出 ValueError
                raise ValueError("指定的作者不存在")

# 注册预处理钩子到Book的PATCH接口
manager.create_api(Book, methods=['GET', 'POST', 'PATCH'], preprocessors={
    'PATCH_SINGLE': [book_patch_preprocessor]
})

这个方法在请求到达ORM层之前就修改了数据，确保传入的是SQLAlchemy能识别的实例。

总结 #

如果只是修改图书标题，方案1是最推荐的——既简洁又符合规范。如果业务上必须在PATCH请求中保留嵌套的作者结构，方案2或3都能解决你的问题，让框架正确处理关联实例。

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