SQLAlchemy URL 再解析丢了空查询值，2.1.6 可显式保留

SQLAlchemy 的 URL 原本包含 query={"x": ""}，转成字符串仍能看到 ?x=，再交给 make_url()，查询字典里的 x 却不见了。先区分“解析时忽略空值”和“字符串根本没带上参数”：前者是这里要处理的情况。

在 SQLAlchemy 2.0.54 中，字符串解析调用 parse_qsl() 时没有保留空值；URL.update_query_string() 也走相同规则。2.1.6 加入了显式保留选项，但默认仍为 False。只升级版本、保持原调用方式，不会让空值自动留下。

2.1.6 可以在解析入口明确保留

下面是纯 URL 处理示例，不建立数据库连接。db.example、数据库名及参数名仅用于展示结构：

from sqlalchemy import URL, make_url

original = URL.create(
    "postgresql+psycopg",
    host="db.example",
    database="app",
    query={"x": ""},
)
serialized = original.render_as_string()
restored = make_url(serialized, keep_blank_values=True)
assert restored.query["x"] == ""

updated = restored.update_query_string("y=", keep_blank_values=True)
assert updated.query["y"] == ""

keep_blank_values 是 2.1.6 新增参数，不能直接复制到 2.0.54。项目准备采用 2.1 时，应同时检查已有 SQLAlchemy 接口、方言和锁定依赖的兼容性；不要为了一个解析参数跳过整个小版本系列的迁移检查。

如果值来自凭据管理系统，核对过程只比较脱敏后的键名及空值是否存在，不输出带密码的完整连接字符串。默认隐藏密码的 URL 文本也不应被当作凭据备份，再拿脱敏文本重建真实连接。

旧版本可保留 URL 对象，避免这次字符串往返

URL.create(query={"x": ""}) 与 URL.update_query_dict({"x": ""}) 本来就能保存空字符串。接口允许时，直接把构造好的 URL 对象传给 create_engine()；必须保存文本时，保留原始配置，并在受控的构造步骤显式补回已知空值键。不要在重新解析后猜测哪些缺失键原本是空值。

这不意味着任何驱动都应收到空字符串。一些整型或布尔型连接参数会在方言层转换，诸如 connect_timeout= 可能因此触发数值转换错误。保留空值应由该参数的实际约定决定，不能全局把所有缺失配置补成 ""。libpq 的某些空参数与未提供参数等效，字典发生变化也不一定代表数据库会话行为改变。

修改前保存原配置和依赖锁文件。验收应分别覆盖 x=、省略 x、普通非空值及重复查询键，比较解析后的映射，再用实际方言核对连接参数；最后验证应用真正关心的会话设置。若回退调用方式，恢复原配置语义，不把一份已经丢键的映射覆盖原始配置。