Django中__startswith不区分大小写问题及大小写敏感查询需求

问题根因 #

你遇到的问题是因为数据库里username字段的排序规则（collation）默认是不区分大小写的，导致Django的__startswith和__istartswith表现一致——都返回了大小写不敏感的结果。Django的查询行为会直接继承数据库底层的排序规则特性。

可行解决方案 #

方案1：修改数据库字段排序规则（推荐，长期有效） #

如果能调整数据库结构，直接把username字段的排序规则改成大小写敏感的：

• MySQL/MariaDB：将字段排序规则改为utf8mb4_bin（二进制匹配，严格区分大小写）或utf8mb4_cs（大小写敏感排序规则，部分版本支持）
• PostgreSQL：把字段类型改为varchar(n) COLLATE "C"或text COLLATE "C"（C排序规则严格区分大小写）
• SQLite：创建表时给username字段指定COLLATE BINARY，或者后续通过ALTER TABLE修改

修改完成后，__startswith就会自动按照大小写敏感的逻辑返回结果，无需改动代码。

方案2：不修改数据库，用代码实现大小写敏感查询 #

如果不能改数据库结构，可以通过调用数据库原生函数来强制大小写敏感匹配：

针对MySQL/MariaDB

用BINARY操作符强制二进制匹配：

from django.db.models import Value, Func

User.objects.filter(username__startswith=Func(Value("AbC"), function='BINARY'))

针对PostgreSQL

有两种方式：

1. 指定排序规则进行LIKE匹配：

User.objects.filter(username__startswith="AbC").extra(
    where=["username COLLATE \"C\" LIKE %s || '%'"],
    params=["AbC"]
)

2. 使用大小写敏感的正则匹配：

from django.db.models import Regexp
User.objects.filter(username__regex=r'^AbC')

针对SQLite

用BINARY关键字强制匹配：

User.objects.extra(where=["BINARY username LIKE ?"], params=["AbC%"])

方案3：自定义可复用的查询表达式 #

如果需要多次使用大小写敏感的startswith查询，可以封装一个自定义表达式：

from django.db.models import Func, Value
from django.db import models

class CaseSensitiveStartsWith(Func):
    template = "%(function)s(%(field)s) LIKE %(pattern)s"
    function = "BINARY"

    def __init__(self, field, value, **kwargs):
        super().__init__(
            field=field,
            pattern=Value(f"{value}%"),
            output_field=models.BooleanField(),
            **kwargs
        )

# 使用示例
User.objects.filter(CaseSensitiveStartsWith('username', 'AbC'))

验证 #

调整后重新执行查询，应该只会返回<User: AbC>和<User: AbCuuu>两条结果，符合你预期的大小写敏感逻辑。

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