FastHTML中处理可选同名复选框列表查询参数的正确方式

我完全懂你碰到的这个糟心问题——用FastHTML写路由处理HTMX传来的同名复选框参数时，多选场景跑得顺顺当当，但没选任何复选框就直接抛400错误，试着给参数加默认值None吧，单文件名又被拆成了字符列表，直接从请求对象取参数还只能拿到最后一个值，确实挺折腾人的。

其实解决这个问题的核心是用FastHTML底层依赖的参数解析能力，通过Annotated结合Query来明确标记参数的可选性和类型：

from typing import Annotated
from fasthtml import Query
import pathlib

@rt.get("/files")
def files_selected(my_files: Annotated[list[pathlib.Path] | None, Query()] = None):
    # 把None转为空列表，方便后续统一处理
    my_files = my_files or []
    print("\n".join(f.name for f in my_files))

为啥之前的方法都不好使？我给你拆解下原因：

• 直接写list[pathlib.Path] | None = None时，FastHTML没法识别你要的是列表类型的可选参数，它会把单个字符串当成可迭代对象，所以就把文件名拆成了一个个字符。
• 直接从req.query_params取值的话，默认只会返回最后一个同名参数，要获取全部得用req.query_params.getlist("my_files")，但这样还得手动把字符串转成pathlib.Path实例，既麻烦又容易出错。

用Annotated+Query()标记后，FastHTML就能精准get你的需求：

• 当HTMX传多个my_files参数时，自动转换成pathlib.Path实例的列表
• 当没有传my_files参数时，会使用默认的None（你可以直接转成空列表统一处理）
• 即使只传一个文件，也会正确包装成单元素列表，不会拆成零散字符

测试下几种场景：

• 请求/files?my_files=foo.txt&my_files=bar.txt：my_files会是[Path('foo.txt'), Path('bar.txt')]
• 请求/files?my_files=foo.txt：my_files会是[Path('foo.txt')]
• 请求/files：my_files会是None，经函数内处理后变成空列表

这样就能完美覆盖所有情况啦！

备注：内容来源于stack exchange，提问作者Phrogz