在 WTForms 2.x 中，FieldList 本身不支持顶层 Optional 验证器，且通过 --form 提交 JSON 数组字符串（如 'patch_bases=[2,4]'）时，WTForms 无法自动解析为 Python 列表，导致始终为空；推荐绕过 FieldList，改用 request.form.get() + ast.literal_eval() 安全解析。
在 wtforms 2.x 中，`fieldlist` 本身不支持顶层 `optional` 验证器，且通过 `--form` 提交 json 数组字符串（如 `'patch_bases=[2,4]'`）时，wtforms 无法自动解析为 python 列表，导致始终为空；推荐绕过 fieldlist，改用 `request.form.get()` + `ast.literal_eval()` 安全解析。
WTForms 的 FieldList 设计初衷是配合 HTML 表单中重复命名的字段（例如多个 <input name="patch_bases">）使用，而非解析 JSON 格式的数组字符串。当你在 cURL 中使用 --form 'patch_bases=[2, 4]' 时，Flask 的 request.form 实际收到的是键 "patch_bases" 对应的字符串值 "[2, 4]"，而非已解析的列表。而 WTForms 的 FieldList(IntegerField()) 期望接收的是多个同名字段的原始值（如 patch_bases=2&patch_bases=4），它不会尝试对单个字符串做 json.loads 或 eval 解析——因此无论是否加 Optional()，form.patch_bases.data 永远是空列表 []。
✅ 正确做法：放弃 FieldList，手动解析表单字段
直接从 request.form 中提取字符串并安全转换：
from ast import literal_eval
from flask import request
# 在视图函数中（非表单类内）
patch_bases_raw = request.form.get("patch_bases")
patch_bases = None
if patch_bases_raw is not None:
try:
# 安全解析字符串为 Python 字面量（仅支持 list/tuple/int/float/None/bool/str）
parsed = literal_eval(patch_bases_raw)
if isinstance(parsed, list) and all(isinstance(x, int) for x in parsed):
if 0 <= len(parsed) <= 5: # 符合业务约束：0–5 个整数
patch_bases = parsed
else:
return form_error_response({"patch_bases": ["Must contain 0–5 integers."]})
else:
return form_error_response({"patch_bases": ["All items must be integers."]})
except (ValueError, SyntaxError):
return form_error_response({"patch_bases": ["Invalid list format. Use e.g., '[1, 2, 3]'."]})
# 此时 patch_bases 可能为 None、[] 或 [2, 4]⚠️ 注意事项：
-
绝不要使用
eval()——ast.literal_eval()是唯一安全的选择，它只允许基础字面量，杜绝代码注入风险； -
request.form.get("patch_bases")返回None当字段未提交（满足“None表示未指定”的需求），返回字符串当字段存在（如"[2, 4]"）； - 若需同时校验文件上传（如你的场景），此方式与
FileField完全兼容，因request.form和request.files是正交的； - 如未来升级至 WTForms ≥ 3.0，可探索自定义
FieldList子类或JSONField扩展，但当前 2.0.2 版本无原生支持。
总结：WTForms 是表单驱动验证库，不是通用数据解析器。面对 --form 提交的结构化字符串，主动解析 + 显式校验，比强行适配 FieldList 更清晰、可靠且可控。
