PAYATHON 2026

Django Graphene 多次查询时撇号重复转义

数据小陈

结论

Django Graphene 不会因为执行多个 GraphQL 查询,就把数据库里的单个撇号变成两个。Chocolate''s 更常见的原因是某一层自定义代码转义了字符串,而多查询、缓存、连接字段复用或响应处理让这次转义执行了两次;数据写入数据库时也可能已经被转义。先找到 Chocolate''s 第一次出现的位置,再判断应该修哪里。

可能原因

  1. CustomFilterConnectionField、SimplePOSObjectType 或 ExtendedConnection 里改写了字段解析、节点序列化、转义或缓存逻辑,把 ' 换成了 '',或者对已经转义过的字符串又处理了一遍。
  2. GraphQL 响应中间件、模板/HTML 转义或前端展示层把同一个字符串转义了两次。GraphQL/JSON 这一层不需要把单引号变成两个单引号。
  3. 数据库里存的可能就是 Chocolate''s。用 ORM 和原始 SQL 看一下实际值,确认是不是数据问题,别把它当成查询问题。

排查步骤

  1. 先看数据库和 ORM 返回的值:
from app.models import Category

obj = Category.objects.get(pk=1)
print(repr(obj.name))

如果这里已经是 Chocolate''s,问题在数据写入或导入阶段。

  1. 打印 resolver 交给 Graphene 序列化层之前的值:
class CategoryNode(DjangoObjectType):
    # ...

    def resolve_name(self, info):
        value = self.name
        print('resolver name repr:', repr(value))
        return value

如果 resolver 里是 Chocolate's,但 GraphQL 原始响应中是 Chocolate''s,继续检查 CustomFilterConnectionField、ExtendedConnection、中间件和响应序列化。

  1. 直接看 GraphQL 原始 JSON,不要只看浏览器页面或前端渲染结果。原始 JSON 正确而页面显示错误,修复点在前端或模板展示层;原始 JSON 已经错了,问题就在服务端的解析/序列化链路。

  2. 做最小复现,临时替换自定义类。先看 categories = CustomFilterConnectionField(CategoryNode) 这一行,再分别替换 SimplePOSObjectType 和 ExtendedConnection。替换到哪一步后 '' 消失,问题就在对应的自定义类里。

修复方式

修复时,只在确实需要转义的边界转义一次,不要在 GraphQL 字段 resolver 里把单引号换成两个单引号。普通 GraphQL 字符串直接返回数据库值:

def resolve_name(self, info):
    return self.name

不要用 replace 手工把 ' 换成 '',也不要在 GraphQL 层同时做 HTML 转义和 SQL 转义。名称要显示在 HTML 中,就让 Django 在模板里自动转义一次,或在前端用 textContent 写入;名称要进入 SQL 条件,就用 ORM 参数化查询。GraphQL 返回的是 JSON,单引号不需要特殊处理。

注意事项

  • 先确认数据库里的原始值,再改代码。
  • 重点看 CustomFilterConnectionField、SimplePOSObjectType、ExtendedConnection 里有没有 replace、escape,或者把已转义结果缓存起来的逻辑。
  • 用缓存时,确认缓存的是原始字符串,不要把转义后的展示字符串写回缓存。
  • 修完后用单查询、多查询和并发请求分别验证,并检查 GraphQL 原始 JSON、模板渲染和前端展示这三处。

备注:内容仅供参考。