WTForms中实现可选IntegerField列表并正确解析表单数据的问题

你遇到的问题核心有两个：一是multipart/form-data格式下传递列表的方式错误，二是FieldList的默认行为和你期望的「无字段返回None、空列表返回[]、有效列表返回对应值」的需求不匹配。下面一步步给你解决：

1. 修正curl请求的列表传递方式 #

当用--form（即multipart/form-data格式）发送列表时，不能直接传JSON字符串[2,4]——WTForms的FieldList期望的是多个同名的表单字段项，而不是单个包含数组的字符串。

正确的curl调用应该把每个列表元素作为单独的patch_bases字段：

curl \
    -v \
    -X POST \
    -H "Authorization: Bearer $(set -eu; cat token)" \
    --form 'patch_bases=2' \
    --form 'patch_bases=4' \
    --form 'file=@your_upload_file.ext' \
    http://hostname:8080/api/v3/publish

2. 调整WTForms表单定义，匹配你的需求 #

你的原始表单定义有两个问题：

• FieldList默认在没有收到任何数据时会返回空列表，而不是你想要的None
• 子字段IntegerField没有明确的验证规则，导致无效数据（比如你之前传的[2,4]字符串）被静默忽略，最终得到空列表

修改后的表单类：

from wtforms import IntegerField, FieldList, FlaskForm
from wtforms.validators import DataRequired, Optional, NumberRange

class PublishForm(FlaskForm):
    patch_bases = FieldList(
        # 子字段必须是有效的正整数，确保输入合法
        IntegerField(validators=[DataRequired(), NumberRange(min=1)]),
        min_entries=0,
        max_entries=5,
        validators=[Optional()]
    )

    def process(self, formdata=None, obj=None, data=None, extra_filters=None, **kwargs):
        # 先执行默认的process逻辑
        super().process(formdata, obj, data, extra_filters, **kwargs)
        # 如果表单数据中完全没有patch_bases字段，将值设为None（而不是默认的空列表）
        if formdata is not None and 'patch_bases' not in formdata:
            self.patch_bases.data = None

3. 验证三种场景是否符合预期 #

• 场景1：完全不传入patch_bases字段：form.patch_bases.data会是None
• 场景2：传入多个有效整数（如patch_bases=2、patch_bases=4）：得到[2,4]
• 场景3：主动传入空列表：如果需要明确触发空列表，可以约定传入一个空的patch_bases字段，但要注意此时需要去掉子字段的DataRequired验证（避免空值触发错误），调整后子字段为IntegerField(validators=[Optional(), NumberRange(min=1)])，此时传--form 'patch_bases='会得到空列表。

备选方案：支持JSON格式的列表输入（如果你坚持要传[2,4]字符串） #

如果因为某些原因，你必须通过--form 'patch_bases=[2,4]'这种方式传列表，可以自定义一个支持JSON解析的字段，直接解析表单中的JSON字符串为列表：

from wtforms import Field, ValidationError
from wtforms.validators import Optional
import json

class JSONIntegerListField(Field):
    def process_formdata(self, valuelist):
        if not valuelist:
            self.data = None
            return
        
        raw_value = valuelist[0].strip()
        try:
            parsed_list = json.loads(raw_value)
            # 验证是否是整数列表
            if not isinstance(parsed_list, list):
                raise ValidationError("patch_bases must be a list of integers")
            for item in parsed_list:
                if not isinstance(item, int) or item <=0:
                    raise ValidationError(f"Invalid integer value: {item}")
            # 验证列表长度
            if len(parsed_list) >5:
                raise ValidationError("patch_bases can have at most 5 elements")
            self.data = parsed_list
        except json.JSONDecodeError:
            self.errors.append("patch_bases must be a valid JSON list")
        except ValidationError as e:
            self.errors.append(str(e))

class PublishForm(FlaskForm):
    patch_bases = JSONIntegerListField(validators=[Optional()])
    # 其他字段（如FileField）...

这个方案下，你的原始curl调用就能正常工作，且完全匹配你的需求：

• 不传patch_bases → None
• 传patch_bases=[] → []
• 传patch_bases=[2,4] → [2,4]

为什么你之前会得到空列表？ #

你之前传--form 'patch_bases=[2,4]'时，WTForms的FieldList会把这个字符串作为单个IntegerField的输入值，但"[2,4]"不是有效的整数，所以子字段验证失败，最终FieldList过滤掉无效数据，返回空列表。又因为你没有给子字段加DataRequired，整个表单验证仍然通过，这就是你看到的奇怪现象。

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