Flask-WTF表单单元测试失败：提交数据无法传递至表单

嘿，我一眼就瞅出问题出在哪了——你给LoginForm设置了prefix='form-login-'，但测试提交数据的时候完全没带上这个前缀，表单根本接收不到对应字段的值，validate_on_submit()当然一直返回False啦！

问题根源 #

Flask-WTF的表单前缀会自动给每个字段的HTMLname属性加上前缀，比如你设置的form-login-，那用户名字段的实际name会变成form-login-username，密码字段是form-login-password。而你测试里提交的是username和password，和表单期望的字段名完全不匹配，所以表单接收到的全是空值，验证自然失败。

快速修复方案 #

只需要在测试提交数据时，给每个字段名加上对应的前缀就行：

修改test_login.py中的test_login方法：

def test_login(self):
    response = self.client.post(
        '/login',
        data={
            'form-login-username': 'a',
            'form-login-password': 'a'
        })
    # 可以加断言验证重定向是否成功
    self.assertEqual(response.status_code, 302)
    self.assertEqual(response.location, url_for('myapp.home', _external=False))

更灵活的写法（避免硬编码前缀） #

如果你担心以后前缀修改需要手动改测试代码，可以先实例化表单，通过字段的name属性获取正确的键名：

# 记得导入LoginForm
from app import LoginForm

def test_login(self):
    form = LoginForm(prefix='form-login-')
    response = self.client.post(
        '/login',
        data={
            form.username.name: 'a',
            form.password.name: 'a'
        })
    self.assertEqual(response.status_code, 302)

排障小技巧 #

要是不确定表单实际的字段名，你可以先请求登录页面，打印响应的HTML内容，查看input标签的name属性：

def test_inspect_form_fields(self):
    response = self.client.get('/login')
    print(response.data.decode('utf-8'))

这样就能直观看到表单期望的字段名，确保提交的数据键名和它一致。

另外确认下你禁用CSRF的配置是生效的——你在setUp里修改self.app.config['WTF_CSRF_ENABLED'] = False是没问题的，测试客户端会使用这个配置。

内容的提问来源于stack exchange，提问作者funkid