Django中Postgres JSON字段数字键查询被识别为索引的解决方案咨询

这个问题我之前也碰到过，Django ORM对JSON字段的数字形式字符串键处理确实容易踩坑。核心问题是当你用data__10__startswith的时候，ORM会把10当成JSON数组的整数索引解析，而不是你实际需要的字符串键'10'，导致生成的SQL用了无引号的10，无法匹配目标数据。

不用编写原生SQL的话，有两种优雅的解决方式：

方法一：使用KeyTextTransform函数（Django 1.11+ 可用） #

KeyTextTransform是Django提供的专门用于提取JSON字段中指定键对应文本值的数据库函数，它可以明确告诉ORM你要访问的是字符串键，而非数组索引。

示例代码：

from django.db.models.functions import KeyTextTransform
from django.db.models import TextField

# 先通过annotate提取出data字段中键'10'对应的值，命名为data_10
queryset = MyModel.objects.annotate(
    data_10=KeyTextTransform('10', 'data', output_field=TextField())
).filter(data_10__startswith='2017')

这段代码生成的SQL会正确使用data ->> '10'来提取值，然后对提取出的文本应用LIKE '2017%'过滤，完全符合你的需求。

方法二：使用F()表达式直接访问JSON键（Django 3.2+ 推荐） #

如果你使用的是较新的Django版本，可以直接通过F()表达式结合JSON键的索引语法来访问字符串键，写法更直观：

示例代码：

from django.db.models import F

queryset = MyModel.objects.filter(
    F('data')['10'].startswith('2017')
)

这种写法直接通过F('data')['10']定位到JSON字段中键为'10'的值，然后调用startswith方法完成过滤。生成的SQL同样会使用带引号的'10'作为JSON键，完美解决索引与字符串键混淆的问题。

补充说明 #

如果你的Django版本低于1.11，虽然可以用extra()方法临时解决，但extra()已经被官方废弃，强烈建议升级到支持上述方法的版本，以保证代码的可维护性和兼容性。

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