含特殊字符的请求参数查询MongoDB无结果，固定值却正常？

你的问题是HTTP请求中的UTF-8特殊字符（如ä）被错误解析为CP1252编码，导致MongoDB正则查询匹配失败。Python 3默认字符串编码就是UTF-8，不需要修改全局默认编码，问题出在请求参数的解析环节。

原因拆解 #

• 硬编码含ä的字符串时，Python直接以UTF-8处理，和数据库中存储的UTF-8数据匹配正常；
• 但请求传入的参数被框架错误用CP1252解码，导致字符的字节表示变形，自然匹配不到数据库里的正确数据。

可行修复方案 #

1. 精准修正参数编码（直接有效） #

既然确认参数原本是UTF-8编码，被错误解析成了CP1252，直接反转编码逻辑修复即可：

@router.get("")
def get_something_data(name: Optional[str] = None):
    query = {}

    if name:
        # 将错误解析的字符串转回字节，再用UTF-8重新解码
        fixed_name = name.encode('cp1252').decode('utf-8')
        query.update({"Name": re.compile(fixed_name, re.IGNORECASE)})

    db = pymongo.MongoClient("localhost:whatever")
    database = db[os.environ["DB_SOMETHING"]]
    collection = database[os.environ["COLL_SOMETHING"]]

    return list(collection.find(query))  # 修正原代码的语法错误：多了一个右括号

2. 排查框架/服务器的编码配置（根治问题） #

如果用的是FastAPI/Starlette这类框架，默认应该是UTF-8解析参数，但可能服务器或反向代理强制设置了CP1252：

• 检查Nginx/Apache的配置，确保请求头的Content-Type或Accept-Charset设为UTF-8；
• 给FastAPI添加中间件强制UTF-8编码：

from fastapi import FastAPI
from starlette.middleware.base import BaseHTTPMiddleware

app = FastAPI()

class ForceUTF8Middleware(BaseHTTPMiddleware):
    async def dispatch(self, request, call_next):
        request.scope["encoding"] = "utf-8"
        response = await call_next(request)
        response.headers["Content-Type"] = "application/json; charset=utf-8"
        return response

app.add_middleware(ForceUTF8Middleware)

3. 别碰Python全局默认编码 #

Python 3的默认编码已经是UTF-8，强行修改（比如用sys.setdefaultencoding）会破坏全局环境，引发更多未知问题，完全没必要。

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