GET 请求里传数组，request.args.getlist() 才是正解
很多人用 request.args.get('ids') 想取到多个同名参数，结果只拿到最后一个值。这是因为 GET 中重复的 query 参数（如 ?id=1&id=2&id=3）在 Flask 里默认只保留末项，必须显式调用 getlist()。
常见错误现象：request.args.get('tags') 返回字符串 "a,b,c" 或单个值，不是列表；手动 .split(',') 又容易漏掉空格、URL 编码问题。
-
request.args.getlist('ids')直接返回['1', '2', '3']，原生支持多值，不依赖分隔符 - 前端需按标准方式构造 URL：
?filter[]=1&filter[]=2或?filter=1&filter=2（后者更通用） - 注意：
getlist()返回的是字符串列表，类型转换得自己做，比如[int(x) for x in request.args.getlist('ids')] - 如果前端用
filter=1,2,3这种逗号分隔形式，就不是标准多值，得用get()+split()，但要提前strip()和过滤空项
POST 表单提交数组，request.form.getlist() 和 request.form.get() 行为一致
表单中多个 <input name="item"> 默认被合并成一个 key 多值，和 GET 的 query string 逻辑相同。别误以为 POST 就自动是 JSON —— 只有 Content-Type 是 application/json 时才走 request.get_json()。
使用场景：管理后台批量操作、多选 checkbox 提交、带文件的混合表单。
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- HTML 中 checkbox 必须同名且带
value：<input type="checkbox" name="role" value="admin">，没选中的不会出现在请求体里 -
request.form.getlist('role')返回选中的所有value字符串，未选则为空列表 -
request.form.get('role')只返回第一个匹配值（或None），千万别用来取多选结果 - 如果表单混用了 JSON 和 form-data（比如用
fetch发FormData），后端不能调get_json()，会返回None
POST JSON 里嵌套数组，request.get_json() 后直接按字典取值
这是最接近“真正数组”的场景：前端发的是标准 JSON，比如 {"users": [{"id": 1}, {"id": 2}]}。但很多人卡在 get_json() 返回 None，其实是 Content-Type 不对或请求体为空。
常见错误现象：request.get_json() 返回 None；json.loads(request.data) 报 JSONDecodeError；取 data['items'] 报 KeyError。
- 确保前端设置
Content-Type: application/json，否则 Flask 不解析request.data -
request.get_json()默认在解析失败时返回None，加silent=False可抛异常便于调试：request.get_json(silent=False) - 取数组字段前务必检查键是否存在：
data = request.get_json() or {}，再用data.get('items', []) - 不要对
request.data重复调json.loads()——get_json()已经做过一次解析，再解析会出错
Flask 处理数组参数的兼容性陷阱：Query、Form、JSON 混用时别硬套同一套逻辑
同一个接口既要支持 curl 测试（GET）、浏览器表单（POST form）、前端 fetch（JSON），很容易写出一堆 if-elif 判断来源，最后变成维护噩梦。核心问题是：三种载体的数组表达方式根本不同，强行统一反而增加歧义。
性能影响不大，但可读性和后期扩展代价很高 —— 比如加个文件上传，form-data 就彻底没法和 JSON 共用解析路径。
- 别写“自动检测数据来源”的万能解析函数，它迟早漏 case；按 Content-Type 或请求方法明确分流更可靠
- GET 和 Form 使用
getlist()，JSON 使用get_json()+ 字典取值，这是 Flask 的设计契约，别绕开 - 如果必须兼容多种方式（如开放 API），建议用不同 endpoint 区分，比如
/api/v1/items/batch?ids=1,2,3（GET）和/api/v1/items/batch（POST JSON） - 最容易被忽略的一点：测试时用
curl -X POST -d "a=1&a=2"发送表单，和用-H "Content-Type: application/json" -d '{"a":[1,2]}'是完全不同的解析路径，漏测一种就线上报错
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
