解决Django Raw Queryset参数绑定错误：避免id内置函数陷阱

本文深入探讨了在Django中使用raw查询时，因误将Python内置函数id作为参数传入而导致的ProgrammingError。文章详细解释了该错误的根源，提供了正确的参数绑定方法，即使用具体的对象属性如product.id，并建议在多数情况下优先考虑Django ORM以提升代码的可读性和维护性，避免不必要的原始SQL查询。

理解ProgrammingError的根源：id函数与参数绑定

在Django开发中，当我们需要执行复杂的SQL查询而Django ORM无法直接满足时，Model.objects.raw()方法提供了一个强大的途径来执行原始SQL。然而，在使用此方法时，参数绑定是一个常见的陷阱。问题中出现的ProgrammingError: "Error binding parameter 1: type 'builtin_function_or_method' is not supported"错误，其核心原因在于将Python的内置函数id()误用作了SQL查询的参数。

Python内置的id()函数用于返回对象的“身份”，即其内存地址。当您在raw查询的参数列表中使用[id]时，Python解释器会将其解析为对内置id函数的引用，而不是您期望的产品ID值。数据库驱动程序在尝试将一个函数对象绑定到SQL查询的参数位置时，会因为无法识别其数据类型而抛出上述错误。

正确的做法是，如果您想传递某个特定对象的ID属性，例如product对象的ID，您应该明确地引用该属性，即product.id。

修正参数绑定错误

以下是修正后的views.py代码片段，展示了如何正确地将product的ID作为参数传递给raw查询：

from django.shortcuts import render
from .models import Variants, Product # 假设Product模型存在

def product_details_view(request, product_id): # 假设product_id从URL获取
    # 获取产品对象，这里需要根据实际情况获取
    try:
        product = Product.objects.get(id=product_id)
    except Product.DoesNotExist:
        # 处理产品不存在的情况，例如返回404
        pass

    if product.variant is not None: # 假设product.variant是某种标识
        variants = Variants.objects.filter(product_id=product.id)

        # 确保variants列表不为空，以避免索引错误
        if variants.exists():
            first_variant_size_id = variants[0].size_id
        else:
            # 处理没有变体的情况，例如设置默认值或返回空列表
            first_variant_size_id = None 

        colors = Variants.objects.filter(
            product_id=product.id, 
            size_id=first_variant_size_id
        ) if first_variant_size_id else Variants.objects.none()

        # 核心修正：使用 product.id 而非内置的 id 函数
        sizes = Variants.objects.raw(
            'SELECT * FROM core_variants WHERE product_id=%s GROUP BY size_id',
            [product.id], # 正确的参数绑定
        )

        # 确保variants列表不为空
        variant = Variants.objects.get(id=variants[0].id) if variants.exists() else None
    else:
        # 处理 product.variant 为 None 的情况
        sizes = []
        colors = []
        variant = None

    context = {
        'sizes': sizes,
        'colors': colors,
        'variant': variant,
    }

    return render(request, 'core/product-details.html', context)

在上述代码中，关键的修改是将[id]替换为[product.id]。这确保了raw查询接收到的是product对象的实际ID值，而不是Python内置的id函数。

Perplexity

Perplexity是一个ChatGPT和谷歌结合的超级工具，可以让你在浏览互联网时提出问题或获得即时摘要

302 查看详情

优化与最佳实践：优先使用Django ORM

尽管raw查询在某些特定场景下非常有用，但通常情况下，Django ORM提供了更安全、更易读且更具可维护性的解决方案。对于上述示例中的需求，即获取特定产品的所有变体，并按size_id进行分组，Django ORM可以很优雅地实现：

# 使用Django ORM实现按 size_id 分组
# 获取所有不重复的 size_id 及其相关信息
unique_sizes = Variants.objects.filter(product_id=product.id).values('size_id', 'size_id__title').distinct()

# 如果需要获取完整的 Variants 对象，但按 size_id 分组，可能需要更复杂的 ORM 查询
# 例如，获取每个 size_id 对应的第一个 Variant 对象
# 这种情况下，raw 查询可能确实更直接，但也可以通过子查询或窗口函数模拟

对于获取按size_id分组的变体，并需要显示size_id的标题（假设size_id是一个外键到Size模型，并且Size模型有title字段），可以这样实现：

# 假设 Variants 模型有一个 ForeignKey 到 Size 模型，名为 'size'
# class Variants(models.Model):
#     product = models.ForeignKey(Product, on_delete=models.CASCADE)
#     size = models.ForeignKey(Size, on_delete=models.CASCADE)
#     # ... 其他字段

# 获取所有不重复的尺寸及其标题
sizes = Variants.objects.filter(product_id=product.id).values('size__id', 'size__title').distinct()

# 在模板中迭代 sizes
# <select name="size" id="size" class="form-control">
#     {% for item in sizes %}
#     <option value="{{ item.size__id }}">{{ item.size__title }}</option>
#     {% endfor %}
# </select>

注意事项：

1. 避免变量名冲突： 在编写代码时，尤其是在函数或方法内部，应避免使用与Python内置函数（如id、list、dict、str等）相同的变量名，以防止混淆和意外行为。
2. 安全性： 使用raw查询时，务必注意SQL注入风险。Django的raw方法会正确地对参数进行转义，但如果您拼接SQL字符串而不是使用参数绑定，则存在风险。始终使用参数绑定方式（如%s占位符和参数列表）。
3. 可读性和维护性： 优先考虑使用Django ORM。ORM查询通常比原始SQL更易于理解和维护，并且在数据库迁移和抽象方面提供了更好的支持。只有当ORM无法满足复杂查询需求时，才考虑使用raw查询。
4. 错误处理： 在访问查询集元素（如variants[0]）之前，务必检查查询集是否为空，以避免IndexError。

总结

ProgrammingError: "Error binding parameter 1: type 'builtin_function_or_method' is not supported"这一错误清晰地指出了在Django raw查询中参数绑定时，将Python内置函数id误用为数据值的常见问题。解决此问题的关键在于明确区分Python内置函数和对象属性，并确保在传递参数时使用正确的属性引用（例如product.id）。同时，本教程强烈建议开发者在多数情况下优先采用Django ORM进行数据库操作，以提高代码的健壮性、可读性和可维护性，仅在特定复杂场景下才考虑使用raw查询。

以上就是解决Django Raw Queryset参数绑定错误：避免id内置函数陷阱的详细内容，更多请关注其它相关文章！

# 如何做  # 物流网站建设课程的心得  # 产品推广认可乐云seo  # 中山seo网站推广  # 义乌电商网站的建设  # 文学网站建设意义  # seo入门带你了解权重  # 荔湾关键词排名推广  # 百度网站优化设置在哪里  # 汾阳学校网站建设  # 外贸seo渠道有哪些  # 变量名  # 邮件处理  # 的是  # python  # 正确地  # 而不是  # 为空  # 情况下  # 是一个  # 绑定  # 常见问题  # django  # sql注入  # ai  # cad  # go  # html 

相关文章： Golang切片为何属于引用类型_Golang slice底层结构与引用语义说明  TypeScript/J*aScript：高效查找数组中首个唯一ID对象  千牛数据看板网页版_千牛数据看板网页版访问方法  《刺客信条：影》PS5 Pro和Switch 2画面对比  俄罗斯Yandex免登录入口_Yandex搜索引擎官网一键直达  凉拌黄瓜怎么拌更入味 凉拌黄瓜简单家常做法  Composer的 "conflict" 字段有什么用_如何声明不兼容的包以避免依赖冲突  Win11输入法不见了怎么办_Windows11恢复语言栏显示方法  b站怎么取消点赞_b站点赞取消操作方法  移动端XML文件怎么转换成Excel 手机和平板上的解决方案  PHP实现即时文章发布与单次数据库写入：自提交模式教程  企业名称高精度匹配：N-gram方法在结构相似性分析中的应用  css元素hover动画延迟生效怎么办_使用animation-delay调整触发时间  Angular Material 垂直步进器：实现底部到顶部排序的教程  小米汽车11月交付量突破40000台！雷军：将继续努力  b站怎么看视频的弹幕数量_b站弹幕数量查看方法  响应式容器内容自动缩放与宽高比维持教程  海量存储：机器视觉智能化的核心基石  谷歌浏览器无痕模式怎么开 Chrome开启无痕浏览设置方法【教程】  妖精漫画网页版登录入口免费_妖精漫画官网主页直接阅读漫画  Archive of Our Own官网直达 AO3最新可用地址一览  正确连接J*aScript到HTML实现可点击图片与自定义事件处理  KFC套餐升级怎么获取优惠代码_KFC套餐升级活动与优惠代码获取方法  C++如何使用AddressSanitizer(ASan)_C++调试工具中检测内存访问错误的利器  《铁拳8》黑皮辣妹新实机：元气满满的18岁少女！  漫蛙网页登录入口 漫蛙漫画官方授权网址  我的世界mc.js免费游戏直接能玩 我的世界mc.js小游戏免费秒玩入口  大麦的“候补”是什么意思 大麦候补购票规则【详解】  Yii2模块参数配置指南：正确声明与访问模块级配置  MongoDB聚合管道：正确匹配对象数组中_id的方法  UC浏览器网页版登录入口官网 电脑版网址入口  PySpark中高效提取字符串右侧可变长度数字：使用regexp_extract  极速漫画官方主页网址 极速漫画漫画在线浏览官网链接  怎么在浏览器上运行HTML文件_浏览器运行HTML文件技巧【技巧】  C++编译期如何执行复杂计算_C++模板元编程(TMP)技巧与应用  C++如何实现异步操作_C++11使用std::future和std::async进行异步编程  mysql如何分析事务日志_mysql事务日志分析方法  必由学官方登录入口 必由学教师学生账号快速访问  使用Pandas转换并合并DataFrame：多列映射至统一结构  夸克浏览器桌面版同步不了书签怎么处理 夸克浏览器跨设备同步异常解决方案  从OpenAI API响应中高效提取生成文本  QQ邮箱官方网页版登录 QQ邮箱个人邮箱快速访问  韩剧圈正版入口页面_韩剧圈官网登录链接  在PHP脚本中通过SSHFS挂载远程文件系统的最佳实践与常见问题解决  解决Rails应用中内容错位与Turbo警告：meta标签误用导致富文本渲染异常  抖音创作助手登录入口_抖音创作辅助工具官网直达  Golang如何优化CPU绑定任务分配策略_Golang CPU任务分配优化实践  qq游戏手机版下载安装_qq游戏移动端入口  顺丰快递查询系统 官方正版查询入口  在Go开发中优雅管理ListenAndServe进程：GoSublime集成方案